Vai al contenuto

Metodi di pagamento · Colombia

Bre-B in Colombia: pagamenti istantanei, in entrata e in uscita

Assegna a ogni cliente un conto virtuale con la propria chiave Bre-B per incassare, e paga le chiavi Bre-B dei beneficiari in tempo reale, 24/7.

Contatta le venditeVai alla documentazione
  • Bonifico istantaneo
  • Colombia
  • Incasso · Payout

Dati chiave

Bre-B dopo i primi mesi

Dati attribuiti al Banco de la República.

Che cos’è

Il circuito di pagamento istantaneo della Colombia

Bre-B è il sistema di pagamento istantaneo della Colombia, lanciato il 6 ottobre 2025 dalla Banca Centrale Banco de la República. Il denaro passa da conto a conto in pochi secondi, a qualsiasi ora. Con Localpayment lo usi in due modi: per incassare, con un conto virtuale identificato da una chiave Bre-B, e per pagare le chiavi Bre-B dei beneficiari.

  • Conto virtuale identificato da una chiave Bre-B (codice 2006)
  • Pay-in sulla chiave, 24/7, confermati via webhook
  • Payout verso chiavi Bre-B in tempo reale, 24/7 (codice 0062)

Come funziona

Come si incassa un bonifico Bre-B

Attori e passaggi seguono il flusso documentato. Lo stato finale arriva sempre tramite webhook firmato.

  1. 1

    La tua aziendaLocalpayment:

    Crea il conto virtuale

    POST /api/virtual-account, singolarmente o in batch. Il numero o la chiave nel formato locale, pronto da condividere.

  2. 2

    La tua aziendaCliente:

    Condivide i dati di pagamento

    Nel tuo checkout, in fattura o nell’app.

  3. 3

    ClienteBanca · Bre-B:

    Fa il bonifico dalla sua banca

    Solo bonifici elettronici; i versamenti in contanti non vengono accreditati.

  4. 4

    LocalpaymentLa tua azienda:

    Webhook: pagamento ricevuto

    Localpayment abbina automaticamente il bonifico al conto virtuale. Webhook firmato con dati del pagatore e importo; i fondi sono accreditati sul tuo saldo Localpayment.

Schema semplificato. Le tempistiche dipendono dal circuito e dalla banca; vedi i dati chiave qui sotto.

Come funziona

Come funziona un payout con Bre-B

Attori e passaggi seguono il flusso documentato. Lo stato finale arriva sempre tramite webhook firmato.

  1. 1

    La tua aziendaLocalpayment:

    Invia la richiesta di payout

    POST /api/payout/ con i dati del beneficiario, l’importo e l’externalId. Si applicano i controlli di compliance; con requireAuth, un secondo approvatore firma prima di muovere i fondi.

  2. 2

    LocalpaymentBanca · Bre-B:

    Blocca i fondi e invia l’istruzione

    Il payout passa da Locked a In Progress tramite Bre-B.

  3. 3

    Banca · Bre-BBeneficiario:

    Accredita il beneficiario

    Le tempistiche dipendono dal circuito; vedi i dati chiave qui sotto.

  4. 4

    LocalpaymentLa tua azienda:

    Webhook: payout completato

    Localpayment aggiorna il payout allo stato finale. Webhook firmato con lo stato finale; la prova di pagamento è scaricabile.

Schema semplificato. Le tempistiche dipendono dal circuito e dalla banca; vedi i dati chiave qui sotto.

Come funziona

Bre-B in azione

Un percorso semplificato e fittizio. Nomi e importi sono esempi.

  1. 1Comercio EjemploIl checkout mostra i dati del conto per pagare COP 185.000,00.
  2. 2Banco EjemploIl pagatore trasferisce COP 185.000,00 sul conto indicato.
  3. 3Pagamento confermatoIl tuo sistema riceve il webhook firmato e rilascia l’ordine.
Contatta le vendite

Dati chiave

Bre-B: dati chiave

  • Paese

    Dettaglio
    🇨🇴 Colombia

  • Valuta

    Dettaglio
    COP

  • Direzione

    Dettaglio
    Incasso e payout

  • Incasso · Conto virtuale (chiave Bre-B)

    Dettaglio
    In tempo reale, confermato via webhook · COP 1 – 11.000.000

  • Payout · Chiave Bre-B

    Dettaglio
    In tempo reale, 24/7 · COP 1 – 11.552.000

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 Bre-B

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 tuo checkout mostra una chiave Bre-B come @LPTechColomb0001, generata alla creazione del conto virtuale. Il cliente apre l’app della banca, sceglie “trasferimento per chiave”, digita la chiave, inserisce l’importo e conferma. Il bonifico si regola in tempo reale e il webhook parte quando i fondi sono interamente accreditati.

  • Limiti documentati

    Conto virtuale (chiave Bre-B) (Incasso): COP 1 – 11.000.000 · Chiave Bre-B (Payout): COP 1 – 11.552.000. Per transazione, secondo la documentazione pubblicata; i limiti contrattuali possono variare.

  • Rimborsi e resi

    Un bonifico accreditato si rimborsa con PATCH /api/payin/{externalId}/refund. Sono supportati solo rimborsi totali e i fondi tornano automaticamente sul conto di origine del pagatore, senza dati aggiuntivi del beneficiario. I versamenti in contanti non vengono mai accreditati.

Checklist di integrazione

Vai in produzione con Bre-B in cinque passi

La stessa sequenza per ogni circuito. Guarda il checkout animato di questo paese prima di sviluppare.

  1. Ottieni le credenziali Stage

    Richiedi l’accesso, ricevi le credenziali sandbox e ottieni un JWT con POST /api/token/.

  2. 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.

  3. Mostra le istruzioni

    Mostra il QR, il codice, il reindirizzamento o i dati del conto della risposta e rispetta la data di scadenza.

  4. Verifica il webhook

    Valida x-Signature (HMAC-SHA256), rilascia l’ordine allo stato 200 e deduplica su externalId.

  5. Guarda il checkout animato

    Ogni metodo di questo paese, schermata per schermata, nella galleria delle esperienze di checkout.

Storia

Come la Colombia ha costruito un circuito istantaneo interoperabile

Fonte: Banco de la República, “Bre-B: Sistema de Pagos Inmediatos Interoperado de Colombia”, documento tecnico, feb. 2026.

  1. Strategia per i pagamenti istantanei

    Il Banco de la República decide di far interoperare i sistemi di pagamento di basso valore della Colombia tramite una directory centrale di chiavi e il regolamento in tempo reale.

  2. Regole per gli SPBVI

    La banca centrale emana la regolazione dei sistemi di pagamento di basso valore interoperabili e definisce lo standard comune delle chiavi (llave).

  3. Chiavi, poi piena operatività

    La registrazione delle chiavi apre a metà 2025; la piena operatività arriva nel secondo semestre, con bonifici P2P gratuiti per gli utenti.

  4. 90 milioni di chiavi

    Sono registrate oltre 90 milioni di chiavi e 218 entità partecipanti, con più di 370 milioni di operazioni regolate in tempo reale dal lancio.

Perché Localpayment

Perché usare Bre-B con Localpayment

  • Un’unica API per incassi e payout

    Bre-B 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

FAQ

Bre-B: domande frequenti

Quanto velocemente viene confermato un pagamento Bre-B?

Bre-B è un circuito in tempo reale che conferma in pochi secondi, 24/7. Per i pay-in lo stato finale arriva tramite webhook firmato: costruisci il flusso degli ordini su questa notifica.

Quali sono i limiti?

L’intervallo documentato per i conti virtuali va da COP 1 a 11.000.000, e i payout verso chiavi Bre-B arrivano fino a COP 11.552.000. Consulta la tabella dei dati chiave e conferma i tuoi limiti con il tuo account manager.

Posso incassare e pagare con Bre-B?

Sì. Incassi con un conto virtuale identificato da una chiave Bre-B e paghi le chiavi Bre-B dei beneficiari in tempo reale, 24/7.

Come si costruisce la chiave Bre-B di un conto virtuale?

In modo deterministico dal nome del beneficiario passato alla creazione: prefisso @, LP, i primi dieci caratteri del nome e un contatore a quattro cifre (da 10 a 16 caratteri in totale). Non si può scegliere una chiave arbitraria.

Come invio un payout a una chiave Bre-B?

Invia POST /api/payout/ con paymentMethod.code 0062, type BankTransfer e flow DIRECT, e inserisci la chiave del destinatario in beneficiary.bank.account.alias; ometti tipo e numero di conto.

Un pay-in Bre-B può essere rimborsato?

Sì, integralmente, con PATCH /api/payin/{externalId}/refund. I fondi tornano automaticamente sul conto di origine del pagatore e il pay-in termina in 902 (REFUNDED).

Quali sono gli stati del payout?

100 Received, 101 Locked (compliance superata), 102 In Progress (inviato a Bre-B), 200 Completed (accreditato) e 300 Rejected, ciascuno consegnato via webhook firmato.

Aggiungi Bre-B ai tuoi incassi

Raccontaci i tuoi mercati e i volumi. Parti con le credenziali Stage (sandbox) e ti accompagniamo fino al go-live.

Contatta le venditeVai alla documentazione

Come possiamo aiutarti?

Scarica la tua copia

Lasciaci i tuoi dati e ricevi subito l’edizione completa.