Antes de começar
Certifique-se de ter:- Credenciais de API válidas (token de acesso).
Etapa 1. Criar pagamento PSE
Para iniciar um pagamento PSE na Colômbia, envie uma solicitaçãoPOST 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 usandocurl:
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
- Iniciação de pagamento: Redirecionar o cliente para o URL de pagamento da PSE.
- 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.

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:Lista bancária
Lista bancária
- 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:- Pagamento bem-sucedido: Fluxo completo de pagamento PSE com simulação bancária.
- Autenticação bancária: Teste diferentes fluxos de autenticação bancária.
- Expiração do pagamento: Gerencie a expiração da sessão de pagamento de forma adequada.
- Falha na autenticação: teste cenários de falha no login bancário.
- 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.

