For AI agents: visit https://docs.asaas.com/llms.txt for an index of all pages formatted in Markdown and endpoints in OpenAPI.
Jump to Content
Discord
Status
Home
Guias / Guides
Recipes
Referência / Reference
Changelog
Sugestões
Breaking changes
v3
Discord
Status
Log In
Guias / Guides
Search
Ask AI
Log In
v3
Home
Guias / Guides
Recipes
Referência / Reference
Changelog
Sugestões
Breaking changes
Cloudflare Firewall Blocking
Select YOUR Language
Português 🇧🇷
English 🇺🇸
POrtuguês
Comece aqui
Introdução
Canais de suporte
Collections
Postman
Insomnia
Como o Asaas trata receitas na conta?
BaaS (Banking As A Service) com o Asaas
Segurança
Autenticação
Chaves de API
Padrão de chave com $ e clientes PHP
Mecanismo para validação de saque via webhooks
Whitelist de IPs
PCI-DSS
MCP Server (IA)
Sandbox
Como configurar sua conta no Sandbox
Adicionando saldo em uma conta Sandbox
Como testar funcionalidades em sandbox
Testando pagamento com cartão de crédito
Testando pagamento de contas
Testando transferências
Testar pagamento de QRCodes Pix
Tentar pagar QR Code Pix no Sandbox sem chave cadastrada = erro 404
Como testar ações críticas
Como gerar novas cobranças de uma assinatura
O que pode ser testado?
Aprovação de contas
FAQ - Sandbox
Cobranças
Introdução - Cobranças
Cadastro de clientes
Cobranças via boleto
Cobranças via cartão de crédito
Cobranças via Pix
Criar uma cobrança parcelada
Redirecionamento após o pagamento
Chargeback
Estornos
Pix
Introdução - Pix
Cobranças via Pix / QR Code dinâmico
Criando um QR Code estático
Pix Recorrente
Diferença entre Pix Recorrente e Pix Automático
Consultar Chave Pix
Pix Automático
Implementação
Fluxos de Webhook do Pix Automático
Motivos de Recusa
Diferença entre Pix Automático e Assinaturas
Processo de retentativas (Jornada 3 API)
FAQ do Pix Automático
Assinaturas (recorrência)
Introdução - assinaturas
Criando uma assinatura
Criando assinatura com cartão de crédito
Emitir notas fiscais automaticamente para assinaturas
Fluxo de bloqueio de assinatura por divergência de split
Diferença entre Pix Automático e Assinaturas
FAQ - Assinaturas
Link de pagamento
Introdução - Link de pagamento
Criando um link de pagamentos
Asaas Checkout
Introdução - Asaas Checkout
Como informar os dados do cliente
Checkout para Pix
Checkout para Cartão de Crédito
Checkout com Assinatura (recorrente)
Checkout com Split de Pagamento
Link do checkout e redirecionamento do cliente
Erros comuns e boas práticas
Split de pagamento
Introdução - Split de pagamento
Split em cobranças avulsas
Split em parcelamentos
Split em assinaturas
Split em cobranças antecipadas
Consulta de splits via interface
Usando o split sem API
Split no WooCommerce
Split na Pluga
Antecipações
Introdução - Antecipação
Notificações
Introdução - Notificações
Notificações padrões
Alterando notificações de um cliente
Transferências
Introdução - Transferências
Transferência para contas de outra instituição (Pix / TED)
Transferência para conta Asaas
Notas fiscais
Introdução - Notas Fiscais
Configurar informações fiscais
Emitindo notas fiscais de serviço
Configurações de retenção e situação tributária de PIS/COFINS
Webhooks
Introdução - Webhooks
Criar novo Webhook pela aplicação web
Criar novo Webhook pela API
Receba eventos do Asaas no seu endpoint de Webhook
Como implementar idempotência em Webhooks
Polling vs. Webhooks
Eventos de Webhooks
Eventos para cobranças
Eventos para assinaturas
Eventos para notas fiscais
Eventos para transferências
Eventos para pague contas
Eventos para antecipações
Eventos para recargas de celular
Eventos para verificar situação da conta
Eventos para Checkout
Eventos para bloqueios de saldo
Eventos para movimentações internas
Eventos para chaves de API
Eventos para Pix Automático
Tipos de envio
Logs de Webhooks
Penalização de filas
Fila pausada
Como reativar fila interrompida
Erro 400 (Bad Request)
Erro 403 (Forbidden)
Erro 404 (Not Found)
Erro 408 - Read Timed Out
Erro 500 (Internal Server Error)
Erro Connect Timed Out
Outros Erros
Bloqueio do Firewall na CloudFlare
IPs oficiais do Asaas
FAQ de Webhooks
Subcontas
Criação de subcontas com o BaaS do Asaas
Onboarding e envio de documentos via link
Detalhamento do Fluxo de Aprovação de Subcontas
Criação de subcontas
Confirmação Anual de Dados Comerciais para Subcontas
Alterar o nome de uma subconta PJ via API
Gerenciamento das chaves de API de subcontas
FAQ Período de Avaliação
Pague Contas
Introdução - Pague contas
Pagamento imediato x Pagamento agendado
Regras importantes
Status possíveis
Erros e exceções comuns — Pague Contas
Testando no Sandbox
Boas práticas gerais
Conta Escrow
Introdução - Conta Escrow
Configurando a Conta Escrow para as subcontas
Cobrança da taxa por subconta configurada
Valores sob garantia da Conta Escrow
Liberação dos Valores em garantia
Desabilitando a Conta Escrow
Plugins/Módulos/Parceiros
Shopify
Boleto - Shopify
Pix - Shopify
Cartão de Crédito - Shopify
Configurações gerais
FAQ - Shopify
WooCommerce
Instalando o plugin
Configurações iniciais
Formas de pagamentos
Formas de cobrança
Assinaturas no WooCommerce
Webhooks do WooCommerce
Erros comuns
Split de pagamento no WooCommerce
FAQ - WooCommerce
Emissor NF-e para WooCommerce - BaseERP
Instalação/Configuração
Cadastro/Vínculo de Produtos
Nuvemshop
Instalando o módulo
Configurações iniciais
FAQ - Nuvemshop
Magento
Instalando o módulo
Configurações iniciais
FAQ - magento
Pluga
Introdução - Pluga
Split Asaas no Pluga
FAQ - Pluga
Digital Manager Guru
Introdução - Guru
Make/Integromat
Vantagens/Funcionalidades
Templates
Criar uma cobrança avulsa à partir de uma linha no Google Sheets
Criar uma assinatura à partir de uma linha no Google Sheets
Criar um parcelamento a partir de uma linha no Google Sheets
FAQ - Make/Integromat
N8N
Instalação
Dúvidas frequentes
Assinaturas
Autenticação
Clientes
Cobranças
Limites da API
Notificações
Parcelamentos
Pix
Sandbox
Segurança
Split
Subcontas
Transferências
Webhooks
BaaS Asaas
Tokenização
SDK
Java
English
Getting Started
Welcome to Asaas
Support Channels
Collections
Postman
Insomnia
How does Asaas treat revenue in the account?
Asaas BaaS
Security
Authentication
Additional Security Mechanisms
Mechanism for validating withdrawals via webhooks
PCI-DSS
IP Whitelisting
Sandbox
How to configure your Sandbox account
Adding balance to a Sandbox account
How to Test Features in Sandbox
Testing Credit Card Payment
Testing Bill Payment
Testing Transfers
Testing Pix QR Code Payment
Trying to pay a Pix QR Code in Sandbox without a registered key = 404 error
How to Test Critical Actions
How to Generate New Charges from a Subscription
What can be tested?
Approval of accounts
FAQ - Sandbox
Payments
Introduction - Payments
Creating customers
Bank Slip Charges
Pix Payments
Credit Card Charges
Installment payments
Redirection after payment
Chargeback
Refunds
Bill
Introduction
Immediate Payment X Scheduled Payment
Rules
Possible Statuses
Common Error Messages
Testing in the Sandbox
General Best Practices
Pix
Overview
Payments via Pix or dynamic QR Code
Creating a static QR Code
Recurring Pix
Automatic Pix
Difference Between Recurring Pix and Automatic Pix
Automatic Pix
Implementation
Automatic Pix Webhook Flows
Refusal reasons
Retry process (Journey 3 API)
Automatic Pix FAQ
Subscription
Overview
Creating a subscription
Subscriptions via credit card
Automatically issue invoices for subscriptions
Subscription blocking flow due to split mismatch
Payment links
Introduction - Payment link
Creating a payment link
Asaas Checkout
Introduction - Asaas Checkout
How to provide customer data
Checkout for Pix
Checkout for Credit Card
Checkout with Subscription (Recurring)
Checkout with Payment Split
Checkout link and customer redirection
Common errors and best practices
Payment split
Overview
Split in single payments
Split into installments
Split on subscriptions
Split in anticipated payments
Split query via interface
Using split without API
Split in WooCommerce
Split in Pluga
Anticipations
Introduction
Notifications
Overview
Default notifications
Changing notifications of a client
Webhooks
Introduction
Create a new Webhook through the web application
Create a new Webhook through the API
Receive events from Asaas in your Webhook endpoint
How to implement idempotency in Webhooks
Polling vs. Webhooks
Webhook Events
Events for Payments
Events for subscriptions
Events for invoices
Events for transfers
Events for Bill Payments
Events for Receivable Anticipations
Events for mobile top-ups
Events for account status verification
Events for Checkout
Events for balance blocks
Events for internal transactionsv
Events for API keys
Events for Automatic Pix
Delivery Types
Webhooks logs
Queue Penalty
Paused Queue
How to Reactivate an Interrupted Queue
Error 400 (Bad Request)
Error 403 (Forbidden)
Error 404 (Not Found)
Error 408 - Read Timed Out
Error 500 (Internal Server Error)
Connect Timed Out Error
Other Errors
Cloudflare Firewall Blocking
Official Asaas IP Addresses
Webhooks FAQ
Transfers
Overview
Transfer to accounts at another institution (Pix / TED)
Transfer to Asaas account
Mechanism for validating transfers via webhooks
Invoices
Overview
Configure tax information
Issuing service invoices
Retention and tax status configurations
Subaccounts
Creating subaccounts
Creating Asaas BaaS sub-accounts
Onboarding and sending documents via link
Detailed Subaccount Approval Flow
Annual Business Data Confirmation for Subaccounts
Change the Name of a Business Subaccount via API
Managing sub-account API keys
FAQ Evaluation Period
Escrow Account
Introduction - Escrow Account
Enabling the Escrow Account for Subaccounts
Fee Charging per Configured Subaccount
Funds Guaranteed by the Escrow Account
Release of Guaranteed Funds
Disabling the Escrow Account
Plugins/Modules/Partners
Shopify
Bank slip - Shopify
Pix - Shopify
Credit Card - Shopify
General Settings
FAQ - Shopify
Woocommerce
Installing the plugin
Initial Settings
Payment methods
Billing types
WooCommerce Subscriptions
WooCommerce Webhooks
Common errors
Payment splitting in WooCommerce
FAQ - WooCommerce
NF-e Issuer for WooCommerce - Base ERP
Installation/Configuration
Product registration/linking
NuvemShop
Installing the module
Initial settings
FAQ
Magento
Installing the module
Initial settings
FAQ - Magento
Pluga
Introduction
Asaas Split on Pluga
Digital Manager Guru
Introduction
Make/Integromat
Advantages / Features
Templates
Create a one-time charge from a Google Sheets row
Create a subscription from a Google Sheets row
Create an installment payment from a Google Sheets row
N8N
Installation
Frequently asked questions
Subscriptions
Authentication
Customers
Payments
API Limits
Notifications
Installments
Pix
Sandbox
Security
Split
Subaccounts
Transfers
Webhooks
Tokenization
Powered by
Cloudflare Firewall Blocking
Copy Page
