Pular para o conteúdo principal
A Localpayment permite que os comerciantes processem pagamentos seguros por transferência bancária por meio do ETPAY, o principal gateway de pagamentos do Chile, que viabiliza transferências bancárias diretas e a autenticação junto às principais instituições financeiras chilenas. Este guia descreve o processo para iniciar pagamentos baseados em ETPAY por meio da API da Localpayment, detalhando os parâmetros obrigatórios, o tratamento das respostas e a interpretação dos códigos de status, para uma integração sem complicações com a infraestrutura bancária do Chile.

Antes de começar

Certifique-se de ter:
Somente pagamentos individuais (Perfis de Home Banking) são suportados.Este método de pagamento aceita apenas pagamentos de contas bancárias pessoais. Se payer.type for enviado como COMPANY, a transação será rejeitada.

Passo 1. Criar pagamento ETPAY

Para iniciar um pagamento ETPAY no Chile, envie uma requisição POST 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 usando curl:
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

  1. Iniciação do pagamento: Redirecionar o cliente para o URL de pagamento do ETPAY.
  2. Seleção do banco: O cliente seleciona seu banco chileno dentre as instituições credenciadas.
  3. Autenticação bancária: O cliente acessa seu ambiente de banco online.
  4. Autorização de pagamento: O cliente confirma o pagamento em sua interface bancária.
  5. Confirmação em tempo real: o Localpayment recebe a notificação de pagamento.
  6. 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:
  1. Pagamento concluído com sucesso: Fluxo de pagamento ETPAY finalizado com simulação bancária.
  2. Autenticação bancária: Teste diferentes fluxos de autenticação bancária.
  3. Expiração do pagamento: Lide com a expiração do link de pagamento de forma adequada.
  4. Falha na autenticação: teste cenários de falha no login bancário.
  5. Rejeição bancária: Simule a rejeição de um pagamento por parte do banco.
  6. 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.

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