O que pode ser testado?

Como interpretar esta página

Nem todas as funcionalidades possuem suporte completo no Sandbox. Algumas podem ser homologadas integralmente, enquanto outras dependem de comportamentos específicos, configurações adicionais ou recursos que estão disponíveis apenas em produção.

Utilize esta página como referência durante a homologação para identificar quais recursos podem ser testados e quais exigem procedimentos complementares.

As marcações da tabela devem ser interpretadas da seguinte forma:

✅ Disponível para testes em Sandbox — o fluxo pode ser homologado normalmente.
⚠️ Disponível com restrições — exige pré-requisitos, configurações específicas ou possui comportamento diferente da produção.
❌ Não disponível em Sandbox — a funcionalidade não pode ser homologada integralmente nesse ambiente.

📘
Importante
Quando uma funcionalidade estiver marcada com ⚠️ ou ❌, consulte as observações da própria tabela e os conteúdos relacionados antes de concluir a homologação da integração.

Recomendações para homologação

Antes de iniciar os testes, recomendamos:

configurar corretamente a conta Sandbox;
gerar saldo para os testes financeiros;
configurar webhooks;
validar os cenários de sucesso e falha;
consultar as limitações específicas de cada funcionalidade.

Esses cuidados ajudam a reduzir divergências entre o comportamento observado em Sandbox e o comportamento esperado em produção.

Nem todas as funcionalidades possuem suporte completo no Sandbox. Algumas podem ser testadas normalmente, outras possuem restrições e outras não estão disponíveis nesse ambiente.

Considere as marcações da tabela abaixo da seguinte forma:

✅ Pode ser testado normalmente em Sandbox ⚠️ Pode ser testado com restrições, pré-condições ou comportamento específico ❌ Não pode ser testado em Sandbox ou não possui suporte completo nesse ambiente

Sempre que houver marcação ⚠️ ou ❌, revise as seções explicativas deste guia antes de concluir a homologação do fluxo.

Descrição	Pode ser testada?
Clientes
Criação de clientes	✅
Listar clientes	✅
Recuperar um único cliente	✅
Atualização de clientes	✅
Exclusão de clientes	✅
Restaurar cliente removido	✅
Cobranças
Criação de cobranças	✅
Criação de cobrança com cartão de crédito	✅
Criar uma cobrança parcelada	✅
Criar cobrança com split	✅
Recuperar uma única cobrança	✅
Listar cobranças	✅
Atualizar cobrança existente	✅
Tokenização de cartão de crédito	✅
Remover cobrança	✅
Restaurar cobrança removida	✅
Estornar cobrança	✅
Obter linha digitável do boleto	✅
Layout de boleto com QR Code Pix	❌
Obter QR Code PIX	✅
Confirmar recebimento em dinheiro	✅
Desfazer confirmação de recebimento em dinheiro	✅
Fazer upload de documentos da cobrança	✅
Atualizar definições de um documento da cobrança	✅
Listar/Recuperar documentos de uma cobrança	✅
Excluir documento de uma cobrança	✅
Aplicar descontos, juros e multas em boleto/Pix	❌
Chargeback	⚠️ - É necessário entrar em contato pelo [email protected] e enviar o ID da cobrança que deseja testar no fluxo.
Parcelamentos
Listar/Recuperar parcelamentos	✅
Remover parcelamento	✅
Estornar parcelamento	✅
Assinaturas
Criar assinatura	✅
Listar/Recuperar assinaturas	✅
Listar cobranças de uma assinatura	✅
Criar assinatura com cartão de crédito	✅
Atualizar assinatura	✅
Remover assinaturas	✅
Listar notas fiscais das cobranças de uma assinatura	✅
Criar configuração para emissão de Notas Fiscais	✅
Atualizar configuração para emissão de Notas Fiscais	✅
Recuperar configuração para emissão de Notas Fiscais	✅
Remover configuração para emissão de Notas Fiscais	✅
Link de pagamento
Criar um link de pagamento	✅
Atualizar um link de pagamento	✅
Recuperar um link de pagamento	✅
Listar links de pagamentos	✅
Remover um link de pagamento	✅
Restaurar um link de pagamento	✅
Adicionar uma imagem a um link de pagamento	✅
Recuperar imagem de link de pagamentos	✅
Listar imagens de link de pagamento	✅
Remover imagem de link de pagamento	✅
Definir imagem principal do link de pagamento	✅
Notificações
Atualizar notificação existente	✅
Atualizar notificação existente em lote	✅
Notificações por E-mail	✅
Notificações por SMS	✅
Notificações por WhatsApp	❌ (Não enviado devido ao custo envolvido na mensageria)
Transferências
Transferir para conta ASAAS	✅
Transferir para conta bancária via TED	✅
Transferir para conta bancária via PIX	⚠️ - É possível testar transferências para chaves fornecidas pelo BACEN
Transferir para outra chave PIX	⚠️ - É possível transferir para outras chaves existentes em sandbox
Recuperar uma única transferência	✅
Listar transferências	✅
Antecipações
Solicitar antecipação	✅
Simular antecipação	❌
Recuperar/Listar antecipações	✅
Negativações
Criar uma negativação	✅
Simular uma negativação	✅
Recuperar negativação	✅
Listar negativações	✅
Reenviar documentos	✅
Cancelar negativações	✅
Pagamento de contas
Criar um pagamento de contas	✅
Simular um pagamento de contas	✅
Listar/Recuperar pagamento de contas	✅
Cancelar pagamento de contas	✅
Recargas de celular
Solicitar recarga	✅
Consulta Serasa
Realizar consulta	✅
Recuperar uma consulta	✅
Listar consultas	✅
Extrato
Recuperar extrato	✅
Informações financeiras
Recuperar saldo da conta	✅
Estatísticas de cobranças	✅
Recuperar valores de split	✅
Informações e Personalização da Conta
Recuperar dados comerciais	✅
Recuperar WalletId	✅
Salvar personalização da fatura	✅
Recuperar configurações de personalização	✅
Recuperar número de conta no ASAAS	✅
Notas Fiscais
Agendar nota fiscal	✅
Atualizar nota fiscal	✅
Recuperar uma nota fiscal	✅
Listar notas fiscais	✅
Emitir uma nota fiscal	✅
Cancelar uma nota fiscal	✅
Listar serviços municipais	✅
Informações fiscais
Listar configurações municipais	✅
Criar e atualizar informações fiscais	✅
Recuperar informações fiscais	✅
Pix
Criar uma chave	✅
Recuperar uma única transação	✅
Listar transações	✅
Cancelar uma transação agendada	✅
Criar um QRCode estático	✅
Decodificar um QRCode	✅
Pagar um QRCode	⚠️ - Disponível mediante utilização de QR Code compatível com os cenários suportados em Sandbox. Consulte o guia de testes de QR Code Pix.
Listar chaves	✅
Recuperar uma única chave	✅
Remover chave	❌
Configuração de Webhooks
Criar ou atualizar configuração para Webhook	✅
Recuperar configurações	✅
Conta Asaas/Subcontas
Criar conta	✅
Listar contas	✅
Envio de documentos via link (BaaS)	⚠️ — É preciso pedir aprovação manual para o time de sucesso de integrações

Funcionalidades com restrições ou limitações

Alguns recursos possuem comportamento parcial ou dependem de condições específicas para homologação.

Os cenários mais comuns são:

Funcionalidades com restrições (⚠️)

Esses recursos podem ser testados, mas exigem procedimentos adicionais:

Transferências Pix dependem da utilização de chaves Pix específicas para homologação.
Contestação de chargeback depende de acionamento do time de Sucesso de Integrações.
Envio de documentos via link (BaaS) exige aprovação manual para testes.

Funcionalidades indisponíveis (❌)

Esses recursos não possuem suporte completo em Sandbox ou dependem de integrações externas que não são simuladas no ambiente:

Layout de boleto com QR Code Pix.
Aplicação de descontos, juros e multas em boleto/Pix.
Notificações por WhatsApp.
Simulação de antecipação.
Pagamento de QR Code Pix (quando não suportado pelo cenário específico).
Remoção de chave Pix.

⚠️
Atenção
A indisponibilidade de uma funcionalidade em Sandbox não significa que ela não esteja disponível em produção. Em muitos casos, a limitação existe apenas para simplificar o ambiente de homologação.

Boas práticas

📘
Recomendado

Consulte os guias específicos de cada funcionalidade antes da homologação.

Não assuma que todos os comportamentos observados em Sandbox serão idênticos à produção.

Valide webhooks, atualizações de status e regras de negócio sempre que possível.

Teste cenários de sucesso e falha durante a homologação.

Utilize apenas dados destinados a testes.

Conteúdos relacionados

Como configurar sua conta no Sandbox.
Adicionando saldo em uma conta Sandbox.
Como testar funcionalidades em Sandbox.
Testando transferências.
Testar pagamento de QR Code Pix.
Como testar ações críticas.
Aprovação de contas.