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, diferenças em relação à produção e os recursos disponíveis exclusivamente neste ambiente.

Quando utilizar

Os testes de transferência são recomendados para integrações que precisam:

• validar fluxos de envio de valores;
• homologar transferências Pix;
• homologar transferências via TED;
• validar atualizações de saldo;
• testar webhooks relacionados às transferências;
• verificar o tratamento de cenários de sucesso e falha.

Antes de iniciar os testes, recomenda-se possuir saldo disponível na conta Sandbox e uma chave Pix cadastrada quando necessário.

Consulte também:

• Adicionando saldo em uma conta Sandbox
• Como configurar sua conta no Sandbox

Campos importantes da transferência

Ao realizar uma transferência para outra instituição ou chave Pix, alguns campos possuem papel fundamental na operação:

📘

Importante

Os parâmetros completos estão documentados na referência do endpoint.

Esta página tem como objetivo demonstrar os cenários de homologação disponíveis em Sandbox.

Testando Transferências via Pix

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

O Banco Central disponibiliza chaves Pix fictícias para utilização em ambientes de homologação.

Ao realizar uma transferência para qualquer uma dessas chaves:

• a operação será concluída com sucesso;
• o valor será debitado da conta Sandbox;
• nenhum crédito será realizado em outra conta;
• nenhuma instituição financeira real será acionada.

Chaves Pix fictícias para testes

Nome: João Silva
CPF/CNPJ: 99991111140
Chave Pix: [email protected]

Nome: João Silva Silva
CPF/CNPJ: 99992222263
Chave Pix: [email protected]

Nome: José Silva
CPF/CNPJ: 99993333387
Chave Pix: [email protected]

Nome: José Silva Silva
CPF/CNPJ: 99994444409
Chave Pix: [email protected]

Nome: José da Silva
CPF/CNPJ: 99995555514
Chave Pix: [email protected]

Opção 2: Utilizando chaves Pix de outras contas Sandbox

Você também pode realizar testes utilizando contas Sandbox reais.

Nesse cenário:

• o valor é debitado da conta origem;
• o valor é creditado na conta destino;
• os saldos das duas contas são atualizados;
• é possível validar fluxos de conciliação e recebimento.

Fluxo simplificado:

Conta Sandbox A
        ↓
Transferência Pix
        ↓
Chave Pix da Conta B
        ↓
Conta Sandbox B

Essa abordagem é recomendada quando a integração precisa validar cenários mais próximos da operação real.

❗️

Importante

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

As transferências entre contas Sandbox permitem validar débito, crédito e atualização de saldo.

Testando Transferências via TED

Em ambiente Sandbox, as transferências via TED possuem mecanismos específicos de homologação.

Após iniciar a transferência, a interface do Asaas disponibiliza ações manuais para simular o resultado da operação.

Confirmar transferência

• Simula uma TED concluída com sucesso.
• O valor é debitado da conta.
• O status passa para concluído.

Simular falha

• Simula uma TED recusada.
• O valor não é debitado.
• O status passa para falhou.

Esses controles existem apenas no Sandbox e não estão disponíveis em produção.

Exemplo de homologação

Uma homologação típica de transferência segue o fluxo abaixo:

Adicionar saldo
        ↓
Criar transferência
        ↓
Processar operação
        ↓
Atualizar status
        ↓
Validar saldo
        ↓
Validar integração

Ao final do processo, recomenda-se validar:

• resposta da API;
• atualização dos saldos;
• recebimento dos webhooks;
• atualização do status da transferência.

Possíveis dificuldades

Caso a transferência não seja concluída conforme esperado, verifique:

• se existe saldo disponível na conta Sandbox;
• se a chave Pix foi informada corretamente;
• se os dados bancários da TED estão válidos;
• se a autenticação está sendo realizada com API Key de Sandbox;
• se o ambiente utilizado é realmente o Sandbox.

Diferenças entre Sandbox e Produção

Impactos operacionais

Os testes de transferência permitem validar:

• atualização de saldo;
• regras de conciliação;
• automações financeiras;
• webhooks;
• tratamento de falhas;
• fluxos de crédito e débito.

Uma homologação adequada reduz significativamente problemas operacionais após a entrada em produção.

Referência da API

Veja a chamada para realizar transferências:

Transferir para conta de outra instituição ou chave Pix