Testando transferências

Utilize o Sandbox para homologar transferências Pix e TED sem movimentar valores reais.

Neste fluxo, você pode validar a criação da transferência, as alterações de status, a atualização do saldo e o processamento dos Webhooks relacionados.

📘
Ao concluir este guia, você terá testado transferências Pix e TED e validado o processamento dos resultados pela sua aplicação.

Quando utilizar

Use este fluxo para testar:

envio de valores por Pix;
transferências TED;
atualização de saldo;
conciliação entre contas;
Webhooks de transferências;
cenários de sucesso e falha.

Antes de começar

Você precisa:

Ter uma conta e uma chave de API de Sandbox.
Possuir saldo disponível para o teste.
Ter uma chave Pix cadastrada, quando utilizar outra conta Sandbox como destino.
Utilizar o endpoint de transferências.

Caso a conta não tenha saldo, consulte Adicione saldo à sua conta Sandbox.

Campos principais

Ao criar uma transferência, os principais campos são:

Campo	Finalidade
`value`	Valor da transferência
`operationType`	Tipo da operação, como `PIX` ou `TED`
`pixAddressKey`	Chave Pix de destino
`bankAccount`	Dados bancários do favorecido
`description`	Identificação da operação

Consulte Transferir para outra instituição ou chave Pix para conhecer todos os parâmetros e regras do endpoint.

Teste transferências Pix

No Sandbox, você pode utilizar chaves fictícias do Banco Central ou chaves cadastradas em outras contas Sandbox.

Opção 1: use uma chave Pix fictícia

As chaves abaixo podem ser utilizadas para simular uma transferência concluída com sucesso:

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]

Nesse cenário:

a transferência é simulada como concluída;
o valor é debitado da conta Sandbox;
nenhuma conta recebe o crédito;
nenhuma instituição financeira real é acionada.

Opção 2: transfira entre contas Sandbox

Também é possível utilizar a chave Pix cadastrada em outra conta Sandbox.

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

Nesse cenário:

o saldo é debitado da conta de origem;
o valor é creditado na conta de destino;
os saldos das duas contas são atualizados;
sua aplicação pode validar o fluxo de débito, crédito e conciliação.

⚠️
Transferências para chaves fictícias não geram crédito em outra conta.
Para validar também o recebimento e a atualização do saldo de destino, utilize duas contas Sandbox.

Teste transferências TED

Após criar uma TED no Sandbox, utilize as ações disponíveis na interface para simular o resultado da operação.

Simule uma TED concluída

Selecione a opção para confirmar a transferência.

O Sandbox deverá:

debitar o valor da conta;
atualizar o status da transferência;
simular a conclusão da operação.

Simule uma falha

Selecione a opção para simular a falha da transferência.

O Sandbox deverá:

atualizar o status para falha;
manter ou devolver o valor ao saldo, conforme o comportamento simulado;
permitir que sua aplicação trate a operação não concluída.

📘
As ações manuais de confirmação e falha existem somente no Sandbox.

Valide o resultado

Uma homologação pode seguir este fluxo:

Adicionar saldo
      ↓
Criar transferência
      ↓
Simular o resultado
      ↓
Acompanhar o status
      ↓
Validar o saldo
      ↓
Processar o Webhook

Após cada teste, confirme:

o status HTTP e o corpo da resposta;
o ID retornado pela API;
a alteração do status da transferência;
o débito e, quando aplicável, o crédito do valor;
o recebimento dos Webhooks;
o processamento correto pela sua aplicação.

Caso a transferência não seja criada

Verifique se:

a conta possui saldo suficiente;
a URL e a chave pertencem ao Sandbox;
a chave Pix foi informada corretamente;
os dados bancários da TED são válidos;
os campos obrigatórios foram enviados;
a operação está disponível para teste no Sandbox.

Diferenças entre Sandbox e Produção

Sandbox	Produção
Utiliza operações simuladas	Movimenta valores reais
Aceita chaves Pix fictícias	Exige chaves Pix válidas
Permite simular manualmente o resultado da TED	Depende do processamento bancário
Não aciona instituições financeiras	Depende das instituições envolvidas

O sucesso de uma transferência no Sandbox não garante a conclusão de uma operação semelhante em Produção.

Checklist de homologação

Antes de considerar o fluxo homologado, confirme se sua aplicação:

valida o saldo antes de solicitar a transferência;
trata operações concluídas e recusadas;
acompanha alterações de status;
processa Webhooks de forma idempotente;
impede transferências duplicadas;
registra IDs, horários e resultados;
diferencia Sandbox e Produção;
possui logs e alertas para falhas.

Próximos passos

Updated 4 days ago

Did this page help you?