Pular para o conteúdo principal
A Localpayment permite que comerciantes processem pagamentos online seguros através do PSE (Pagos Seguros en Línea), o sistema oficial de pagamentos bancários online da Colômbia, desenvolvido pela ACH (Automated Clearing House) Colombia. Este guia descreve o processo para iniciar pagamentos via PSE 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 da Colômbia.

Antes de começar

Certifique-se de ter:

Etapa 1. Criar pagamento PSE

Para iniciar um pagamento PSE na Colômbia, envie uma solicitação POST ao endpoint Criar Payin com os parâmetros específicos do PSE.

Parâmetros-chave da solicitação

A solicitação requer vários objetos-chave específicos para pagamentos PSE na Colômbia: 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 PSE 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 PSE para a Colômbia falhar, você receberá informações de erro específicas:

Etapa 3. Gerenciar o fluxo de pagamento PSE

  1. Iniciação de pagamento: Redirecionar o cliente para o URL de pagamento da PSE.
  2. Autenticação bancária: O cliente acessa seu ambiente de banco online.
  3. Autorização de pagamento: O cliente confirma o pagamento em sua interface bancária.
  4. Confirmação em tempo real: o Localpayment recebe a notificação de pagamento.
  5. Atualização de status: Seu sistema recebeu um webhook com a confirmação de pagamento.

Página de login do Bancolombia


Etapa 4. Acompanhe o status da transação

Acompanhe o progresso dos pagamentos do PSE 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.

Requisitos específicos de cada país

Bancos colombianos apoiados (PSE)

Os pagamentos PSE são suportados pelas seguintes instituições financeiras:
  • BANCO DE BOGOTA
  • BANCO POPULAR
  • BANCO ITAU
  • BANCOLOMBIA
  • CITIBANK
  • BANCO GNB SUDAMERIS
  • BANCO BBVA COLOMBIA S.A.
  • DAVIBANK
  • BANCO DE OCCIDENTE
  • BANCO CAJA SOCIAL
  • BANCO AGRARIO
  • BANCO MUNDO MUJER
  • BANCO DAVIVIENDA
  • BANCO AV VILLAS
  • BANCAMIA S.A.
  • BANCO PICHINCHA S.A.
  • BANCOOMEVA S.A.
  • BANCO FALABELLA
  • BANCO FINANDINA S.A. BIC
  • BANCO SANTANDER COLOMBIA
  • BANCO COOPERATIVO COOPCENTRAL
  • BANCO SERFINANZA
  • LULO BANK
  • J.P. MORGAN COLOMBIA S.A
  • DALE
  • CFA COOPERATIVA FINANCIERA
  • JFK COOPERATIVA FINANCIERA
  • COTRAFA CONFIAR COOPERATIVA FINANCIERA
  • BANCO UNION (anteriormente GIROS COLTEFINANCIERA)
  • NEQUI
  • AVIPLATA
  • BAN100
  • IRIS
  • MOVII S.A.
  • UALÁ
  • NU
  • RAPPIPAY
  • ALIANZA FIDUCIARIA S.A.
  • CREZCAMOS
  • BOLD CF
  • DING

Testando sua integração

Ambiente de Sandbox

Utilize o ambiente de teste para realizar os procedimentos:

Cenários de teste para a Colômbia

Verifique se sua integração lida com esses cenários:
  1. Pagamento bem-sucedido: Fluxo completo de pagamento PSE com simulação bancária.
  2. Autenticação bancária: Teste diferentes fluxos de autenticação bancária.
  3. Expiração do pagamento: Gerencie a expiração da sessão de pagamento de forma adequada.
  4. Falha na autenticação: teste cenários de falha no login bancário.
  5. Atualizações de status: gerenciamento de webhooks e consulta de status.

Próximos passos

Após implementar os pagamentos PSE, 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