Pular para o conteúdo principal
Aprenda a testar a integração da sua Virtual Account simulando pagamentos recebidos no ambiente de teste. Valide seus listeners de webhook e a lógica de conciliação sem transferências bancárias reais. Testar a integração da sua Virtual Account é uma etapa crucial antes de entrar em produção. Para facilitar isso, a Localpayment oferece um endpoint de simulação no ambiente de teste que permite acionar um pagamento simulado para qualquer Virtual Account ativa. Esta simulação reproduz o comportamento de uma transferência ACH local real, acionando as mesmas atualizações de status internas e notificações de webhook que você esperaria em um ambiente de produção.

Fluxo de simulação

  1. Create a Virtual Account: Primeiro, gere uma Virtual Account no ambiente de teste.
  2. Get Virtual Account Status: Use o endpoint Get Virtual Account Status para confirmar se a conta foi criada com sucesso e recuperar o campo beneficiary.bank.account.number da resposta.
  3. Link para a simulação: Em sua solicitação de simulação, utilize o beneficiary.bank.account.number obtido na etapa anterior para vincular o pagamento simulado à conta correta. Além disso, forneça um externalId exclusivo: ele funciona como o ID do payin gerado para esta transação; use um externalId diferente para cada solicitação de simulação. Você também deve incluir seu accountNumber Localpayment (ID do comerciante) para identificar a conta comercial associada ao pagamento simulado.
  4. Acionar simulação: Chame o endpoint Simulate a Virtual Account Payment.
  5. Webhook de recebimento: Localpayment enviará um webhook payin.completed (ou similar) para o seu endpoint configurado.
  6. Verificar status: Use a API de status da transação para confirmar se a transação simulada atingiu o estado esperado.

Dependências técnicas

Requisito sequencial: Não é possível simular um pagamento para uma conta que não foi criada com sucesso. Se a chamada Create a Virtual Account falhar, a tentativa de simulação retornará um erro 404 Não Encontrado.

Exemplos de código (Estágio)

Selecione seu mercado-alvo para ver um exemplo completo de curl. Utilize os mesmos dados do beneficiário fornecidos ao criar a Virtual Account e informe um externalId exclusivo para cada solicitação de simulação.

Exemplo de notificação de webhook

Após o processamento bem-sucedido, a Localpayment envia um evento síncrono payin.completed para o seu endpoint configurado. Esta notificação segue a estrutura padrão de alto nível PayIn observada em todos os produtos de pagamento.

Solução de problemas


Próximos passos

Verificar status

Obtenha atualizações de status em tempo real para confirmar o progresso da transação simulada.

Configurar Webhooks

Valide a lógica do seu ouvinte com notificações de sucesso em tempo real.
Última modificação em 10 de novembro de 2026