Metodi di pagamento · Colombia
PSE in Colombia: pay-in direttamente dalla banca del cliente
Offri il pagamento bancario che i colombiani già conoscono. Il cliente viene portato alla sua banca, approva dall’home banking e tu ricevi lo stato finale con un webhook firmato.
- Reindirizzamento bancario
- Colombia
- Incasso
Reindirizzamento bancario- 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" } } }Dati chiave
La Colombia paga dal conto bancario
Fonti: Superintendencia Financiera, CCCE, Banco de la República, Banca Mondiale.
82,4%
Quota delle operazioni tramite canali non in presenza (% delle operazioni, T1 2025)
Fonte: Superintendencia Financiera de Colombia, Informe de operaciones - primer trimestre 2025
684,6 milioni
Transazioni e-commerce (2025)
Fonte: Cámara Colombiana de Comercio Electrónico (CCCE), Informe de cierre 2025 (secondo El Tiempo)
3,6
Bonifici giornalieri conto a conto rispetto alle transazioni con carta (volte, rapporto, 2024)
57,1%
Adulti con un conto, istituto finanziario o mobile money (% degli adulti 15+, 2024)
Fonte: Banca Mondiale, Global Findex Database 2025 (FX.OWN.TOTL.ZS), 2024
Che cos’è
Il pagamento bancario della Colombia
PSE è il metodo di pagamento bancario online usato in Colombia. Invece di inserire i dati di una carta, il cliente sceglie la sua banca, viene portato lì, accede all’home banking e approva il pagamento. Con Localpayment crei il pay-in via API e segui lo stato con un webhook firmato.
- Flusso con reindirizzamento: il pagatore approva nel proprio home banking
- Limite documentato fino a COP 788.800.000 per transazione
- Conferma asincrona, recapitata via webhook firmato
- 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" } } }Come funziona
Come funziona un pagamento con PSE
Attori e passaggi seguono il flusso documentato. Lo stato finale arriva sempre tramite webhook firmato.
- 1
ClienteLa tua azienda:
Seleziona la sua banca
Nel tuo checkout o tramite un link di pagamento.
- 2
La tua aziendaLocalpayment:
Reindirizzamento alla banca
POST /api/payin/ con paese, valuta, importo e dati del pagatore. La risposta include l’URL di reindirizzamento alla banca del pagatore, dove si completa il pagamento PSE. Il pagamento resta in corso finché la banca non conferma.
- 3
ClienteBanca · PSE:
Approva nella sua banca
Il pagatore accede all’home banking e approva il pagamento. Nessun QR da scansionare.
- 4
LocalpaymentLa tua azienda:
Webhook
Localpayment riceve la conferma e aggiorna la transazione. Firmato con HMAC-SHA256 (x-Signature). Lo stato 200 indica completato; deduplica su externalId.
Schema semplificato. Le tempistiche dipendono dal circuito e dalla banca; vedi i dati chiave qui sotto.
Come funziona
PSE in azione
Un percorso semplificato e fittizio. Nomi e importi sono esempi.
- 1Comercio EjemploIl cliente sceglie PSE per pagare COP 350.000,00.
- 2Banco EjemploIl pagatore viene portato alla sua banca per accedere e autorizzare.
- 3Pagamento confermatoIl tuo sistema riceve il webhook firmato e rilascia l’ordine.
Dati chiave
PSE: dati chiave
Paese
- Dettaglio
- 🇨🇴 Colombia
Valuta
- Dettaglio
- COP
Direzione
- Dettaglio
- Solo incasso
PSE
- Dettaglio
- Asincrono, confermato via webhook · Fino a COP 788.800.000
Flusso
- Dettaglio
- Reindirizzamento alla banca del cliente
Stato
- Dettaglio
- Webhook (asincrono)
Tratti dalla documentazione Localpayment di ciascun paese. Limiti e disponibilità possono cambiare; confermali con il tuo account manager.
Esperienza del cliente
Cosa vede il tuo cliente con PSE
Autorizzazione, limiti e rimborsi come documentati su docs.localpayment.com. I limiti sono mostrati solo dove la documentazione li indica.
Come autorizza il cliente
Il cliente viene reindirizzato alla pagina PSE, sceglie banca e tipo di persona, accede all’home banking e conferma lì il pagamento. La sessione ha una data di scadenza (circa sette giorni nell’esempio documentato); il pay-in passa da 100 (INPROGRESS) a 103 (APPROVED) e 200 (Completed) via webhook.
Limiti documentati
PSE (Incasso): Fino a COP 788.800.000. Per transazione, secondo la documentazione pubblicata; i limiti contrattuali possono variare.
Rimborsi e resi
Un pay-in completato si rimborsa con PATCH /api/payin/{externalId}/refund. Sono supportati solo rimborsi totali; il denaro torna su un conto bancario del pagatore e la transazione termina nello stato 902 (REFUNDED). Finché il pagamento è in sospeso può invece essere annullato.
Checklist di integrazione
Vai in produzione con PSE in cinque passi
La stessa sequenza per ogni circuito. Guarda il checkout animato di questo paese prima di sviluppare.
Ottieni le credenziali Stage
Richiedi l’accesso, ricevi le credenziali sandbox e ottieni un JWT con POST /api/token/.
Crea il pay-in
POST /api/payin/ con il codice Localpayment della tabella dei dati chiave, paese ISO-3, valuta, importo e dati del pagatore.
Mostra le istruzioni
Mostra il QR, il codice, il reindirizzamento o i dati del conto della risposta e rispetta la data di scadenza.
Verifica il webhook
Valida x-Signature (HMAC-SHA256), rilascia l’ordine allo stato 200 e deduplica su externalId.
Guarda il checkout animato
Ogni metodo di questo paese, schermata per schermata, nella galleria delle esperienze di checkout.
Storia
Dal reindirizzamento bancario alle chiavi istantanee
Fonti: ACH Colombia (PSE); Banco de la República, documento tecnico Bre-B, feb. 2026.
Nasce PSE
ACH Colombia lancia Pagos Seguros en Línea: gli acquirenti pagano online accedendo alla propria banca e autorizzando un addebito.
Lo standard dell’e-commerce
PSE diventa il checkout conto-a-conto predefinito in Colombia, usato da persone e imprese per acquisti, bollette e tasse.
Regolazione dei pagamenti istantanei
Il Banco de la República pubblica la strategia sui pagamenti istantanei e le regole dei sistemi di pagamento di basso valore (SPBVI) che interopereranno.
Bre-B parte accanto a PSE
Entra in funzione il sistema interoperabile a chiavi della banca centrale; PSE resta il reindirizzamento bancario da browser per l’e-commerce.
Perché Localpayment
Perché usare PSE con Localpayment
Un’unica API per incassi e payout
PSE usa la stessa API di tutti gli altri metodi: POST /api/payin/ per incassare, POST /api/payout/ per pagare e nuovi mercati per configurazione.
Stato via webhook per ogni transazione
Ogni cambio di stato arriva al tuo endpoint firmato con HMAC-SHA256, così puoi verificare e automatizzare.
Riconciliazione nel Business Portal
Riconcilia ogni transazione con il tuo externalId e il nostro internalId, con report del Business Portal e API di saldo.
Continua a esplorare
Incassi
Incassa in valuta locale con i metodi che le persone usano davvero.
Incassi —Colombia
Metodi, circuiti, valute e licenze in Colombia.
Colombia —Bre-B
Circuiti, limiti e flusso, passo dopo passo.
Bre-B —TransfiYa
Circuiti, limiti e flusso, passo dopo passo.
TransfiYa —Metodi per paese
La directory completa di pay-in e circuiti di payout documentati.
Metodi per paese —
FAQ
PSE: domande frequenti
Come funziona un pagamento PSE?
Il cliente sceglie PSE nel tuo checkout, viene portato alla sua banca, accede all’home banking e approva. La conferma è asincrona: lo stato finale arriva tramite webhook firmato, costruisci il flusso degli ordini su di esso.
Qual è il limite di PSE?
Il limite documentato arriva fino a COP 788.800.000 per transazione. Consulta la tabella dei dati chiave e conferma il tuo limite con il tuo account manager.
PSE usa un QR code?
No. PSE è un reindirizzamento bancario: il pagatore approva nell’home banking della sua banca. Per i pagamenti istantanei in Colombia, vedi Bre-B.
Cosa significa lo stato 103 (APPROVED)?
La banca ha confermato l’addebito ma i fondi non sono ancora accreditati a Localpayment. Attendi lo stato 200 (Completed) nel webhook firmato prima di rilasciare la merce.
Un pagamento PSE può essere rimborsato?
Sì, integralmente, con PATCH /api/payin/{externalId}/refund su una transazione completata; il rimborso va su un conto bancario del pagatore e il pay-in termina in 902 (REFUNDED). I rimborsi parziali non sono supportati.
Perché il mio pay-in è stato rifiutato con 811?
Il codice 811 indica che l’importo è sopra o sotto l’intervallo consentito per il metodo. Controlla la tabella dei dati chiave e i limiti del tuo contratto.
PSE funziona per le aziende oltre che per i privati?
PSE supporta persone fisiche e giuridiche; il cliente seleziona il tipo di persona nella pagina PSE e accede con il profilo bancario corrispondente.
Aggiungi PSE ai tuoi incassi
Raccontaci i tuoi mercati e i volumi. Parti con le credenziali Stage (sandbox) e ti accompagniamo fino al go-live.