Pular para o conteúdo principal
Use as contas de teste do Stage para acionar cenários específicos de rejeição de Payout antes de entrar em produção com Payouts por Transferência Bancária. Antes de enviar Payouts a beneficiários reais em Produção, use o ambiente Stage para confirmar que a sua integração lida tanto com Payouts bem-sucedidos quanto com os cenários de rejeição que os bancos dos beneficiários retornam na prática. Este guia cobre o fluxo de sandbox de Payouts por Transferência Bancária e fornece contas de teste dedicadas, uma por país, que acionam de forma determinística cada cenário de rejeição.

Antes de começar


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 como In 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.
  1. Você envia um Payout no Stage usando uma das contas de teste das tabelas abaixo.
  2. A Localpayment valida a estrutura da requisição e, se ela for válida, define o Payout como In Progress enquanto o encaminha para uma resposta bancária simulada.
  3. 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.
  4. 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 REJECTED sem 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 Payout REJECTED 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 mesmo paymentMethod.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.
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ão beneficiary.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.
Última modificação em 12 de novembro de 2026