Pular para o conteúdo principal
Atribua um CVU por transação para a Argentina. O pagamento só será confirmado quando o pagador transferir o valor exato antes do prazo de validade. A Virtual Account com Intenção de Pagamento atribui uma CVU (Cuenta Virtual Uniforme) a cada transação, vinculada a um valor específico e a um prazo de validade. Ao contrário de uma Virtual Account padrão que aceita qualquer depósito, este produto só confirma o PayIn quando o pagador transfere exatamente o valor indicado antes da data de vencimento.

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.
  1. Seu sistema chama POST /api/payin/ com paymentMethod.code: "1060" e o valor esperado.
  2. O Localpayment retorna um CVU exclusivo, os dados bancários do beneficiário e uma data de validade.
  3. Você exibe o CVU, o valor exato e a data de vencimento para o pagador.
  4. O pagador inicia uma transferência bancária para a CVU a partir do seu aplicativo bancário ou carteira digital.
  5. 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ção POST 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)

Se o pagador transferir um valor diferente, a transferência será creditada como um PayIn padrão de Virtual Account e não confirmará a intenção de pagamento.

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:
  1. 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 em wireInstructions. Seu sistema pode usá-la para confirmar a atribuição do CVU.
  2. 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 usando paymentMethod.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.

Última modificação em 10 de novembro de 2026