Antes de começar
Certifique-se de ter:Credenciais da API
Credenciais de API e token de acesso válidos para autenticação.
Configuração da conta
Configuração adequada da conta para o país de destino e verificação da empresa.
Lista branca de IPs
Adicione os endereços IP do seu servidor à lista de permissões para acesso à API.
Endpoint do webhook
Configure um URL de webhook para receber notificações de pagamento.
Como funciona
O fluxo difere da Virtual Account CVU padrão em um aspecto fundamental: a cada pagamento é atribuído um CVU vinculado a um valor específico.- Seu sistema chama
POST /api/payin/compaymentMethod.code: "1060"e o valor esperado. - O Localpayment retorna um CVU exclusivo, os dados bancários do beneficiário e uma data de validade.
- Você exibe o CVU, o valor exato e a data de vencimento para o pagador.
- O pagador inicia uma transferência bancária para a CVU a partir do seu aplicativo bancário ou carteira digital.
- Quando a transferência chega com o valor exato antes do vencimento, o Localpayment confirma o PayIn e envia um webhook para o seu sistema.
Passo 1: Criar uma intenção de pagamento
Envie uma requisiçãoPOST para o endpoint Criar Payin.
Solicitação
Exemplo de solicitação
Resposta bem-sucedida
Campos de resposta principais
Resposta de erro
Etapa 2: Exibir as instruções de pagamento ao pagador.
Após receber a resposta, mostre o seguinte ao pagador:- CVU: o valor de
wireInstructions.beneficiary.bank.account.number - Valor: o valor exato da sua solicitação. O pagador deve enviar esse valor preciso.
- Validade: o prazo de
date.expirationDate - Nome do beneficiário: o valor de
wireInstructions.beneficiary.name(Localpayment S.R.L. como titular registrado da conta)
Etapa 3: Gerenciar notificações de pagamento
Ao contrário de uma virtual account padrão (onde você só recebe um webhook quando um pagamento é creditado), o Pagamento com Intenção aciona dois eventos de webhook:- Notificação de criação (
INPROGRESS): é acionada imediatamente quando a intenção de pagamento é criada, contendo o CVU atribuído e a data de validade emwireInstructions. Seu sistema pode usá-la para confirmar a atribuição do CVU. - Notificação de conclusão (
COMPLETED): é acionada quando a transferência do pagador é processada e o valor exato é recebido antes do vencimento.
Notificação de conclusão (COMPLETED)
Teste no Stage
Use o endpoint Simulate Virtual Account Payment para testar o processo de ponta a ponta no ambiente de teste (Stage) sem realizar transferências bancárias reais. Simule um pagamento bem-sucedido usandopaymentMethod.code: "1060" e o mesmo externalId retornado na resposta de criação.
Demonstração

Próximos passos
Receba notificações de pagamento
Configure seu endpoint de webhook e aprenda como verificar e lidar com notificações PayIn para pagamentos de virtual account.
Obter status da transação
Consulte o endpoint de status da transação para verificar o estado atual de uma intenção de pagamento.
Simular um pagamento
Teste sua integração de ponta a ponta no ambiente de teste, sem transferências bancárias reais.
Visão geral de Virtual Accounts
Conheça todos os produtos de virtual account e seus casos de uso.

