Fluxo de simulação
- Create a Virtual Account: Primeiro, gere uma Virtual Account no ambiente de teste.
- 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.numberda resposta. - Link para a simulação: Em sua solicitação de simulação, utilize o
beneficiary.bank.account.numberobtido na etapa anterior para vincular o pagamento simulado à conta correta. Além disso, forneça umexternalIdexclusivo: ele funciona como o ID do payin gerado para esta transação; use umexternalIddiferente 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. - Acionar simulação: Chame o endpoint Simulate a Virtual Account Payment.
- Webhook de recebimento: Localpayment enviará um webhook
payin.completed(ou similar) para o seu endpoint configurado. - 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 decurl. 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.
- Argentina
- Brasil
- Chile
- Colômbia
- Costa Rica (CRC)
- Costa Rica (USD)
- México (SPEI)
- México (TEF)
- Peru
Exemplo de notificação de webhook
Após o processamento bem-sucedido, a Localpayment envia um evento síncronopayin.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.

