Antes de começar
- Credenciais de API válidas (token de acesso) para o Stage.
- Familiaridade com Enviar fundos por transferência bancária e com a estrutura da requisição Create a Payout.
- Um endpoint de webhook configurado para receber notificações de status de Payout.
Como o sandbox simula rejeições
O Stage não movimenta dinheiro real, mas segue o mesmo fluxo da Produção: a Localpayment recebe a sua requisição, valida a estrutura dela e, se estiver formatada corretamente, define o status comoIn Progress e a encaminha para uma resposta bancária simulada com base nos dados da conta que você enviar. Essa resposta decide se o Payout será aprovado ou rejeitado. Você descobre o resultado da forma habitual: por webhook ou consultando o status da transação.
Qualquer Payout com uma requisição corretamente estruturada é aprovado automaticamente. As contas de teste deste guia são a exceção: cada uma está associada a um motivo de rejeição específico, para que você possa reproduzir essa condição de erro sob demanda, em vez de esperar que ela ocorra naturalmente.
- Você envia um Payout no Stage usando uma das contas de teste das tabelas abaixo.
- A Localpayment valida a estrutura da requisição e, se ela for válida, define o Payout como
In Progressenquanto o encaminha para uma resposta bancária simulada. - A resposta bancária simulada avalia os dados da conta do beneficiário. Uma conta corretamente estruturada que não corresponda a uma das contas de teste abaixo é aprovada automaticamente. Uma conta de teste é rejeitada com o código associado a ela.
- A Localpayment notifica você sobre o status final por meio do seu endpoint de webhook, ou você o obtém consultando a transação. Use isso para confirmar que a sua integração reage corretamente a Payouts
REJECTEDsem precisar esperar por uma rejeição bancária real.
Estas contas de teste são exclusivas do Stage. Enviar um Payout para uma dessas contas em Produção não produzirá o mesmo resultado, pois a Produção encaminha para bancos reais.
Códigos de rejeição
Cada conta de teste abaixo retorna um destes cinco resultados. Todos resultam em um PayoutREJECTED com os status.code e status.description correspondentes.
Contas de teste por país
Cada aba lista os dados bancários do beneficiário de um país. Todos os cenários compartilham o mesmopaymentMethod.code e, salvo indicação em contrário, o mesmo beneficiary.bank.code e beneficiary.bank.name desse país. account.details é o valor a ser enviado em beneficiary.bank.account.number (ou em beneficiary.bank.account.alias, quando indicado) para acionar o código de rejeição correspondente. Description é o status.description que você verá na resposta e no webhook para esse código.
- Argentina
- Bolívia
- Brasil
- Chile
- Colômbia
- Costa Rica
- República Dominicana
- El Salvador
- Guatemala
- Honduras
- México
- Panamá
- Paraguai
- Peru
Método de pagamento: COELSA, código
0010 · Banco: BANCO DE GALICIA (007) · account.type: S · account.details é o CBUaccount.type C (conta corrente) também funciona nesses cenários.Referência de mapeamento de campos
As contas de teste acima preenchem o objeto padrãobeneficiary.bank de Create a Payout:
Números de conta que passam na validação de dígito verificador (CLABE do México, CBU da Argentina e os formatos de IBAN usados por Costa Rica, República Dominicana e El Salvador) são valores de teste estruturalmente válidos, não contas reais. Eles existem apenas para alcançar o cenário de rejeição associado.
Próximos passos
Enviar fundos por transferência bancária
Referência completa da API para criar Payouts por Transferência Bancária, incluindo requisitos específicos de cada país.
Devoluções e Recalls
Entenda o que acontece quando um Payout é rejeitado ou devolvido após a conclusão em Produção.

