Antes de começar
Certifique-se de ter:- Credenciais de API válidas (token de acesso).
- Consulte os limites e regras para transações bancárias.
Passo 1. Criar pagamento ETPAY
Para iniciar um pagamento ETPAY no Chile, envie uma requisiçãoPOST ao endpoint Criar Payin com parâmetros específicos do ETPAY.
Parâmetros-chave da solicitação
A solicitação requer vários objetos-chave específicos para pagamentos ETPAY no Chile:
Veja todos os parâmetros disponíveis na solicitação.
Exemplo de solicitação
Abaixo está um exemplo usandocurl:
curl
Etapa 2. Lidar com a resposta
Resposta bem-sucedida
A criação bem-sucedida de um pagamento ETPAY inclui o URL de redirecionamento e os detalhes da transação:Campos de resposta principais
Resposta de erro
Quando a criação de um pagamento ETPAY falhar para o Chile, você receberá informações de erro específicas:Etapa 3. Gerenciar o fluxo de pagamento ETPAY
- Iniciação do pagamento: Redirecionar o cliente para o URL de pagamento do ETPAY.
- Seleção do banco: O cliente seleciona seu banco chileno dentre as instituições credenciadas.
- Autenticação bancária: O cliente acessa seu ambiente de banco online.
- Autorização de pagamento: O cliente confirma o pagamento em sua interface bancária.
- Confirmação em tempo real: o Localpayment recebe a notificação de pagamento.
- Atualização de status: Seu sistema recebeu um webhook com a confirmação de pagamento.
Etapa 4. Acompanhe o status da transação
Acompanhe o andamento dos pagamentos do ETPAY 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 na resposta.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
Use o ambiente de staging para testes:Cenários de teste para o Chile
Verifique se sua integração lida com esses cenários:- Pagamento concluído com sucesso: Fluxo de pagamento ETPAY finalizado com simulação bancária.
- Autenticação bancária: Teste diferentes fluxos de autenticação bancária.
- Expiração do pagamento: Lide com a expiração do link de pagamento de forma adequada.
- Falha na autenticação: teste cenários de falha no login bancário.
- Rejeição bancária: Simule a rejeição de um pagamento por parte do banco.
- Atualizações de status: gerenciamento de webhooks e consulta de status.
Próximos passos
Após implementar os pagamentos ETPAY, 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.

