Antes de começar
Certifique-se de ter:- Credenciais de API válidas (token de acesso).
Passo 1. Criar pagamento Debin
Para gerar uma solicitação de pagamento Debin, envie uma requisiçãoPOST 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 usandocurl:
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
- Iniciação do pagamento: Seu aplicativo envia uma solicitação DEBIN para a API Localpayment.
- Processamento em Rede Bancária: A Localpayment encaminha pagamentos através do sistema bancário argentino.
- Notificação ao cliente: O cliente recebe alertas em tempo real no aplicativo bancário.
- Autorização de pagamento: O cliente aprova o pagamento diretamente na interface bancária.
- Confirmação e Webhooks: O Localpayment envia um webhook instantâneo com o status final do pagamento.
- 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:- Autorização bem-sucedida: Fluxo de autorização Debin concluído.
- Expiração de autorização: Lidar com solicitações de autorização expiradas.
- 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.

