Introdução

O ambiente Sandbox do Asaas permite a simulação completa de transferências financeiras, possibilitando que você valide integrações com segurança, sem movimentar valores reais.

Este guia explica como realizar testes de transferências via Pix e transferências via TED, destacando os comportamentos esperados e os recursos disponíveis exclusivamente neste ambiente.

Testando Transferências via Pix

Opção 1: Utilizando Chaves Pix Fictícias do BACEN

O Banco Central fornece um conjunto de chaves Pix fictícias, especialmente para testes de transferências em ambientes homologatórios, como o Sandbox do Asaas.

Ao realizar uma transferência para qualquer uma dessas chaves fictícias, a operação:

• Será concluída imediatamente com sucesso.
• O valor será debitado da conta Sandbox.

Não haverá compensação em nenhuma outra conta, pois são chaves fictícias.

Consulte a lista oficial de chaves Pix fictícias fornecidas pelo BACEN:
Ver chaves para teste aqui

Opção 2: Utilizando Chaves Pix de Outras Contas Sandbox

Você pode criar uma chave Pix em sua própria conta Sandbox ou em outra conta Sandbox para realizar testes mais completos.

Nesse caso:

• O valor será debitado da conta origem.
• O valor será creditado na conta destino.

Todo o fluxo ocorre dentro do ambiente Sandbox, permitindo validar cenários reais de débito e crédito.

📘

Exemplo de fluxo:

Conta Sandbox A → realiza Pix → Chave Pix da Conta Sandbox B → Conta B recebe o crédito.

🚧

Importante

As transferências realizadas para chaves fictícias não geram registros de crédito em nenhuma conta.

As transferências entre contas reais do Sandbox simulam perfeitamente a movimentação entre contas bancárias no ambiente de produção.

Testando Transferências via TED

Em ambiente Sandbox, as transferências via TED contam com controles manuais disponíveis exclusivamente na interface do Asaas (não disponíveis via API).

Após iniciar uma transferência TED, você terá duas opções na interface para simular o resultado da operação:

Confirmar Transferência:

• Simula uma compensação bem-sucedida.O valor é debitado da conta Sandbox.
• O status da transferência muda para Concluída.

Simular Falha:

• Simula uma falha na transferência.
• O valor não é debitado da conta.
• O status da transferência muda para Falhou.

❗️

ATENÇÃO:

No Sandbox, nenhuma transferência resulta em movimentações financeiras reais.

• Todos os testes podem ser feitos com segurança, sem risco de impacto em ambientes produtivos.
• O uso de chaves Pix fictícias é recomendado para testar fluxos de sucesso sem necessidade de configurar múltiplas contas.
• Para testar cenários de crédito e débito, utilize múltiplas contas Sandbox com chaves Pix reais.

O ambiente Sandbox do Asaas proporciona um ambiente seguro e controlado para validar todos os fluxos de transferências via Pix e TED, desde casos de sucesso até falhas, garantindo maior qualidade e segurança nas integrações antes da utilização em ambiente de produção.