Meios de pagamento · Colômbia
PSE na Colômbia: pay-ins direto do banco do cliente
Ofereça o pagamento bancário que os colombianos já conhecem. O cliente é levado ao banco, aprova no internet banking e você recebe o status final por webhook assinado.
- Redirecionamento bancário
- Colômbia
- Pay-in
Redirecionamento bancário- 09:41:02.11409:41:02PayIn100 INPROGRESS20084 ms
- 09:41:05.90209:41:05PayIn200 COMPLETED20091 ms
- 09:42:18.33009:42:18PayOut100 INPROGRESS20077 ms
- 09:42:40.01809:42:40PayOut200 COMPLETED20088 ms
- 09:43:00.55109:43:00VirtualAccount200 COMPLETED20080 ms
POST https://example-merchant.com/webhooks/localpayment
x-Signature: HMAC-SHA256 3f9a1c0e…b47e2b
{ "transactionType": "PayIn", "transactionFlow": "DIRECT",
"data": { "externalId": "order_8F2K-1043",
"status": { "code": "200", "description": "COMPLETED" } } }Dados principais
A Colômbia paga pela conta bancária
Fontes: Superintendencia Financiera, CCCE, Banco de la República, Banco Mundial.
82,4%
Participação das operações por canais não presenciais (% das operações, 1º trimestre de 2025)
Fonte: Superintendencia Financiera de Colombia, Informe de operaciones - primer trimestre 2025
684,6 milhões
Transações do e-commerce (2025)
Fonte: Cámara Colombiana de Comercio Electrónico (CCCE), Informe de cierre 2025 (segundo El Tiempo)
3,6
Transferências diárias conta a conta em relação às transações com cartão (vezes, razão, 2024)
57,1%
Adultos com conta em instituição financeira ou de dinheiro móvel (% dos adultos com 15 anos ou mais, 2024)
Fonte: Banco Mundial, Global Findex Database 2025 (FX.OWN.TOTL.ZS), 2024
O que é
O pagamento bancário da Colômbia
O PSE é o método de pagamento bancário online usado na Colômbia. Em vez de digitar os dados de um cartão, o cliente escolhe o banco, é levado a ele, entra no internet banking e aprova o pagamento. Com a Localpayment você cria o pay-in pela API e acompanha o status por webhook assinado.
- Fluxo com redirecionamento: o pagador aprova no próprio internet banking
- Limite documentado de até COP 788.800.000 por transação
- Confirmação assíncrona, entregue por webhook assinado
- 09:41:02.11409:41:02PayIn100 INPROGRESS20084 ms
- 09:41:05.90209:41:05PayIn200 COMPLETED20091 ms
- 09:42:18.33009:42:18PayOut100 INPROGRESS20077 ms
- 09:42:40.01809:42:40PayOut200 COMPLETED20088 ms
- 09:43:00.55109:43:00VirtualAccount200 COMPLETED20080 ms
POST https://example-merchant.com/webhooks/localpayment
x-Signature: HMAC-SHA256 3f9a1c0e…b47e2b
{ "transactionType": "PayIn", "transactionFlow": "DIRECT",
"data": { "externalId": "order_8F2K-1043",
"status": { "code": "200", "description": "COMPLETED" } } }Como funciona
Como funciona um pagamento com PSE
Os atores e as etapas seguem o fluxo documentado. O status final sempre chega por webhook assinado.
- 1
ClienteSua empresa:
Seleciona o banco
No seu checkout ou por um link de pagamento.
- 2
Sua empresaLocalpayment:
Redirecionamento ao banco
POST /api/payin/ com país, moeda, valor e dados do pagador. A resposta inclui a URL de redirecionamento ao banco do pagador, onde o pagamento PSE é concluído. O pagamento fica em andamento até o banco confirmar.
- 3
ClienteBanco · PSE:
Aprova no banco
O pagador entra no internet banking e aprova o pagamento. Não há QR para escanear.
- 4
LocalpaymentSua empresa:
Webhook
A Localpayment recebe a confirmação e atualiza a transação. Assinado com HMAC-SHA256 (x-Signature). O status 200 indica concluído; deduplique por externalId.
Diagrama simplificado. Os prazos dependem do trilho e do banco; veja os dados principais abaixo.
Como funciona
Veja PSE em ação
Um passo a passo simplificado e fictício. Nomes e valores são exemplos.
- 1Comercio EjemploO cliente escolhe PSE para pagar COP 350.000,00.
- 2Banco EjemploO pagador vai ao seu banco para entrar e autorizar.
- 3Pagamento confirmadoSeu sistema recebe o webhook assinado e libera o pedido.
Dados principais
PSE: dados principais
País
- Detalhe
- 🇨🇴 Colômbia
Moeda
- Detalhe
- COP
Direção
- Detalhe
- Somente pay-in
PSE
- Detalhe
- Assíncrono, confirmado por webhook · Até COP 788.800.000
Fluxo
- Detalhe
- Redirecionamento ao banco do cliente
Status
- Detalhe
- Webhook (assíncrono)
Extraídos da documentação da Localpayment de cada país. Limites e disponibilidade podem mudar; confirme com seu gerente de conta.
Experiência do cliente
O que seu cliente vê com PSE
Autorização, limites e reembolsos conforme docs.localpayment.com. Os limites aparecem apenas quando a documentação os informa.
Como o cliente autoriza
O cliente é redirecionado para a página do PSE, escolhe o banco e o tipo de pessoa, entra no internet banking e confirma o pagamento ali. A sessão tem data de expiração (cerca de sete dias no exemplo documentado); o pay-in passa de 100 (INPROGRESS) a 103 (APPROVED) e 200 (Completed) por webhook.
Limites documentados
PSE (Pay-in): Até COP 788.800.000. Por transação, conforme a documentação publicada; os limites contratuais podem variar.
Reembolsos e devoluções
Um pay-in concluído é reembolsado com PATCH /api/payin/{externalId}/refund. Só há reembolsos totais; o dinheiro volta para uma conta bancária do pagador e a transação termina no status 902 (REFUNDED). Enquanto o pagamento está pendente, ele pode ser cancelado.
Checklist de integração
Entre em produção com PSE em cinco passos
A mesma sequência para todos os trilhos. Veja o checkout animado deste país antes de construir.
Obtenha credenciais de Stage
Solicite acesso, receba credenciais de Stage e obtenha um JWT com POST /api/token/.
Crie o pay-in
POST /api/payin/ com o código Localpayment da tabela de dados principais, país ISO-3, moeda, valor e dados do pagador.
Mostre as instruções
Exiba o QR, o código, o redirecionamento ou os dados da conta da resposta e respeite a data de expiração.
Verifique o webhook
Valide x-Signature (HMAC-SHA256), libere o pedido no status 200 e deduplique por externalId.
Veja o checkout animado
Cada método deste país, tela por tela, na galeria de experiências de checkout.
História
Do redirecionamento bancário às chaves instantâneas
Fontes: ACH Colombia (PSE); Banco de la República, documento técnico Bre-B, fev. 2026.
Nasce o PSE
A ACH Colombia lança o Pagos Seguros en Línea para que os compradores paguem online entrando no próprio banco e autorizando um débito.
O padrão do comércio eletrônico
O PSE se torna o checkout conta a conta padrão na Colômbia, usado por pessoas e empresas para compras, contas e impostos.
Regulação dos pagamentos instantâneos
O Banco de la República publica sua estratégia de pagamentos instantâneos e as regras dos sistemas de pagamento de baixo valor (SPBVI) que vão interoperar.
Bre-B entra em operação ao lado do PSE
Começa o sistema interoperável por chaves do banco central; o PSE segue como o redirecionamento bancário pelo navegador para o comércio eletrônico.
Por que a Localpayment
Por que usar PSE com a Localpayment
Uma API para pay-ins e payouts
PSE usa a mesma API de todos os outros meios: POST /api/payin/ para receber, POST /api/payout/ para pagar, a mesma em todos os mercados.
Status por webhook em cada transação
Cada mudança de status chega ao seu endpoint assinada com HMAC-SHA256, para você verificar e automatizar.
Conciliação no Business Portal
Concilie cada transação com seu externalId e nosso internalId, com relatórios do Business Portal e APIs de saldo.
Continue explorando
Pay-ins
Receba em moeda local com os métodos que as pessoas realmente usam.
Pay-ins —Colômbia
Métodos, trilhos, moedas e licenças na Colômbia.
Colômbia —Bre-B
Trilhos, limites e fluxo, passo a passo.
Bre-B —TransfiYa
Trilhos, limites e fluxo, passo a passo.
TransfiYa —Métodos por país
O diretório completo de pay-ins e trilhos de payout documentados.
Métodos por país —
Perguntas frequentes
PSE: perguntas frequentes
Como funciona um pagamento com PSE?
O cliente escolhe PSE no seu checkout, é levado ao banco, entra no internet banking e aprova. A confirmação é assíncrona: o status final chega por webhook assinado; baseie o fluxo dos pedidos nele.
Qual é o limite do PSE?
O limite documentado é de até COP 788.800.000 por transação. Veja a tabela de dados principais e confirme seu limite com seu gerente de conta.
O PSE usa QR Code?
Não. O PSE é um redirecionamento bancário: o pagador aprova dentro do internet banking do próprio banco. Para pagamentos instantâneos na Colômbia, veja o Bre-B.
O que significa o status 103 (APPROVED)?
O banco confirmou o débito, mas os fundos ainda não foram creditados na Localpayment. Aguarde o status 200 (Completed) no webhook assinado antes de liberar a mercadoria.
Um pagamento PSE pode ser reembolsado?
Sim, integralmente, com PATCH /api/payin/{externalId}/refund sobre uma transação concluída; o reembolso vai para uma conta bancária do pagador e o pay-in termina em 902 (REFUNDED). Reembolsos parciais não estão disponíveis.
Por que meu pay-in foi rejeitado com 811?
O código 811 indica que o valor está acima ou abaixo da faixa permitida para o método. Confira a tabela de dados principais e os limites do seu contrato.
O PSE funciona para empresas além de pessoas físicas?
O PSE aceita pessoas físicas e jurídicas; o cliente seleciona o tipo de pessoa na página do PSE e entra com o perfil bancário correspondente.
Adicione PSE aos seus recebimentos
Conte quais são seus mercados e volumes. Você começa com credenciais de Stage (ambiente de testes) e nós acompanhamos até a entrada em produção.