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:

Nome: Joao Silva 
CPF/CNPJ 99991111140
Chave: [email protected]
BANCO Virtual Mensageria 04 (99999004)
AGÊNCIA 0001
CONTA 12345678 CACC)

Nome: Joao Silva Silva 
CPF/CNPJ 99992222263
Chave: [email protected]
BANCOVirtual Mensageria 04 (99999004)
AGÊNCIA 0002
CONTA 11345678 (CACC)

Nome: Jose Silva
CPF/CNPJ99993333387
Chave: [email protected]
BANCOVirtual Mensageria 04 (99999004)
AGÊNCIA 0003
CONTA 12145678(CACC)

Nome: Jose Silva Silva
CPF/CNPJ99994444409
Chave: [email protected]
BANCOVirtual Mensageria 04 (99999004)
AGÊNCIA 0004
CONTA 12315678(CACC)

Nome: Jose da Silva
CPF/CNPJ99995555514
Chave: [email protected]
BANCOVirtual Mensageria 04 (99999004)
AGÊNCIA 0004
CONTA 12341678(CACC)

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 na integração antes da utilização em ambiente de produção.

Veja a chamada para realizar transferências aqui.