Pular para o conteúdo principal
A Localpayment permite que comerciantes processem transferências bancárias instantâneas através do sistema Debin (Débito Imediato) da Argentina. Este guia descreve o processo para iniciar pagamentos Debin através da API da Localpayment, detalhando os parâmetros necessários, o tratamento de respostas e a interpretação de códigos de status para uma integração perfeita com a rede de débito imediato da Argentina.
ImportanteOs pagamentos Debin expiram 2 dias após a data de criação.

Antes de começar

Certifique-se de ter:

Passo 1. Criar pagamento Debin

Para gerar uma solicitação de pagamento Debin, envie uma requisição POST ao endpoint Criar Payin com parâmetros específicos do Debin.
A solicitação de pagamento só pode ser feita para contas CBU. Esses números de conta se distinguem pelo fato de seus três primeiros dígitos não começarem com zero.

Parâmetros-chave da solicitação

A solicitação requer vários objetos-chave específicos para pagamentos Debin: Veja todos os parâmetros disponíveis na solicitação.

Exemplo de solicitação

Abaixo está um exemplo usando curl:
curl

O pagamento só será considerado concluído após o cliente aceitá-lo em seu aplicativo bancário. Caso o cliente o recuse, o pagamento será rejeitado. Do contrário, o pagamento passará para o status de expirado.

Etapa 2. Lidar com a resposta

Resposta bem-sucedida

A criação bem-sucedida de um pagamento Debin inclui os detalhes da solicitação de pagamento e o fluxo de autorização:

Campos de resposta principais

Resposta de erro

Quando a criação da solicitação Debin falhar, você receberá informações detalhadas sobre o erro:

Etapa 3. Gerenciar o fluxo de autorização

  1. Iniciação do pagamento: Seu aplicativo envia uma solicitação DEBIN para a API Localpayment.
  2. Processamento em Rede Bancária: A Localpayment encaminha pagamentos através do sistema bancário argentino.
  3. Notificação ao cliente: O cliente recebe alertas em tempo real no aplicativo bancário.
  4. Autorização de pagamento: O cliente aprova o pagamento diretamente na interface bancária.
  5. Confirmação e Webhooks: O Localpayment envia um webhook instantâneo com o status final do pagamento.
  6. Processamento de Pedidos: Seu aplicativo atualiza o status do pedido com base no resultado do pagamento.

Etapa 4. Acompanhe o status da transação

Acompanhe o progresso dos pagamentos da Debin por meio destes métodos:

Webhooks (Recomendado)

Receba notificações em tempo real quando o status da transação mudar. Ideal para ambientes de produção.

Endpoint da API de Status

Consultar o status da transação programaticamente. Útil para consultar ou recuperar notificações de webhook perdidas.

Visualização do Business Portal

Interface visual para monitoramento de transações. Ideal para supervisão manual e análise detalhada de transações.

Códigos de status comuns

A API Localpayment fornece vários códigos de status para indicar o progresso e o resultado do pagamento Debin.
Referência completaConsulte todos os códigos de status em nossa Documentação de Status da Transação.

Testando sua integração

Ambiente de Sandbox

Utilize o ambiente de teste para realizar os procedimentos:

Cenários de teste Debin

Verifique se sua integração lida com esses cenários:
  1. Autorização bem-sucedida: Fluxo de autorização Debin concluído.
  2. Expiração de autorização: Lidar com solicitações de autorização expiradas.
  3. Atualizações de status: gerenciamento de webhooks e consulta de status.

Próximos passos

Após implementar os pagamentos Debin, considere estas funcionalidades adicionais:

Reembolsar a transação

Caso necessário, você pode reembolsar o pagamento ao cliente. Consulte a documentação para obter detalhes.

Analisar detalhes da transação

Você pode obter informações detalhadas sobre as transações usando a API Localpayment.
Última modificação em 10 de novembro de 2026