Aller au contenu

Moyens de paiement · Colombie

Bre-B en Colombie : des paiements instantanés, à l’encaissement et au décaissement

Attribuez à chaque client un compte virtuel avec sa propre clé Bre-B pour encaisser, et payez les clés Bre-B de vos bénéficiaires en temps réel, 24/7.

  • Virement instantané
  • Colombie
  • Encaissement · Décaissement

Chiffres clés

Bre-B après ses premiers mois

Chiffres attribués à la Banco de la República.

De quoi s’agit-il

Le rail de paiement instantané de la Colombie

Bre-B est le système de paiement instantané de la Colombie, lancé le 6 octobre 2025 par la Banque centrale Banco de la República. L’argent circule de compte à compte en quelques secondes, à toute heure. Avec Localpayment, vous l’utilisez de deux façons : pour encaisser, via un compte virtuel identifié par une clé Bre-B, et pour décaisser vers les clés Bre-B de vos bénéficiaires.

  • Compte virtuel identifié par une clé Bre-B (code 2006)
  • Encaissements sur la clé, 24/7, confirmés par webhook
  • Décaissements vers des clés Bre-B en temps réel, 24/7 (code 0062)

Comment ça marche

Comment encaisser un virement Bre-B

Les acteurs et les étapes suivent le flux documenté. Le statut final arrive toujours par webhook signé.

  1. 1

    Votre entrepriseLocalpayment:

    Crée le compte virtuel

    POST /api/virtual-account, un par un ou par lot. Le numéro ou la clé au format local, prêt à partager.

  2. 2

    Votre entrepriseClient:

    Communique les coordonnées

    Dans votre checkout, sur la facture ou dans l’app.

  3. 3

    ClientBanque · Bre-B:

    Effectue le virement depuis sa banque

    Virements électroniques uniquement ; les dépôts d’espèces ne sont pas crédités.

  4. 4

    LocalpaymentVotre entreprise:

    Webhook : paiement reçu

    Localpayment rapproche automatiquement le virement du compte virtuel. Webhook signé avec les données du payeur et le montant ; les fonds sont crédités sur votre solde Localpayment.

Schéma simplifié. Les délais dépendent du rail et de la banque ; voir les informations clés ci-dessous.

Comment ça marche

Comment fonctionne un décaissement Bre-B

Les acteurs et les étapes suivent le flux documenté. Le statut final arrive toujours par webhook signé.

  1. 1

    Votre entrepriseLocalpayment:

    Envoie la demande de décaissement

    POST /api/payout/ avec les données du bénéficiaire, le montant et l’externalId. Les contrôles de conformité s’appliquent ; avec requireAuth, un second approbateur valide avant tout mouvement de fonds.

  2. 2

    LocalpaymentBanque · Bre-B:

    Bloque les fonds et envoie l’instruction

    Le décaissement passe de Locked à In Progress via Bre-B.

  3. 3

    Banque · Bre-BBénéficiaire:

    Crédite le bénéficiaire

    Les délais dépendent du rail ; voir les informations clés ci-dessous.

  4. 4

    LocalpaymentVotre entreprise:

    Webhook : décaissement terminé

    Localpayment met le décaissement à son statut final. Webhook signé avec le statut final ; la preuve de paiement peut être téléchargée.

Schéma simplifié. Les délais dépendent du rail et de la banque ; voir les informations clés ci-dessous.

Comment ça marche

Bre-B en action

Un parcours simplifié et fictif. Les noms et les montants sont des exemples.

  1. 1Comercio EjemploLe checkout affiche les coordonnées du compte pour payer COP 185 000,00.
  2. 2Banco EjemploLe payeur vire COP 185 000,00 sur le compte indiqué.
  3. 3Paiement confirméVotre système reçoit le webhook signé et libère la commande.

Informations clés

Bre-B : informations clés

  • Pays

    Détail
    🇨🇴 Colombie
  • Devise

    Détail
    COP
  • Sens

    Détail
    Encaissement et décaissement
  • Encaissement · Compte virtuel (clé Bre-B)

    Détail
    Temps réel, confirmé par webhook · COP 1 – 11 000 000
  • Décaissement · Clé Bre-B

    Détail
    Temps réel, 24/7 · COP 1 – 11 552 000

Tiré de la documentation Localpayment de chaque pays. Les plafonds et la disponibilité peuvent évoluer ; confirmez-les avec votre gestionnaire de compte.

Expérience client

Ce que voit votre client avec Bre-B

Autorisation, plafonds et remboursements selon docs.localpayment.com. Les plafonds ne sont affichés que lorsque la documentation les précise.

  • Comment le client autorise

    Votre checkout affiche une clé Bre-B telle que @LPTechColomb0001, générée à la création du compte virtuel. Le client ouvre l’app de sa banque, choisit « virement par clé », saisit la clé et le montant, puis confirme. Le virement est réglé en temps réel et le webhook part une fois les fonds entièrement crédités.

  • Plafonds documentés

    Compte virtuel (clé Bre-B) (Encaissement): COP 1 – 11 000 000 · Clé Bre-B (Décaissement): COP 1 – 11 552 000. Par transaction, selon la documentation publiée ; les plafonds contractuels peuvent différer.

  • Remboursements et retours

    Un virement crédité se rembourse avec PATCH /api/payin/{externalId}/refund. Seuls les remboursements intégraux sont pris en charge et les fonds reviennent automatiquement sur le compte d’origine du payeur, sans données supplémentaires. Les dépôts d’espèces ne sont jamais crédités.

Checklist d’intégration

Passez en production avec Bre-B en cinq étapes

La même séquence pour chaque rail. Regardez le checkout animé de ce pays avant de développer.

  1. Obtenez des identifiants Stage

    Demandez l’accès, recevez des identifiants sandbox et obtenez un JWT via POST /api/token/.

  2. Créez l’encaissement

    POST /api/payin/ avec le code Localpayment du tableau des informations clés, le pays ISO-3, la devise, le montant et les données du payeur.

  3. Affichez les instructions

    Affichez le QR, le code, la redirection ou les coordonnées renvoyés et respectez la date d’expiration.

  4. Vérifiez le webhook

    Validez x-Signature (HMAC-SHA256), libérez la commande au statut 200 et dédoublonnez sur externalId.

  5. Regardez le checkout animé

    Chaque méthode de ce pays, écran par écran, dans la galerie des expériences de paiement.

Historique

Comment la Colombie a bâti un rail instantané interopérable

Source : Banco de la República, « Bre-B: Sistema de Pagos Inmediatos Interoperado de Colombia », document technique, févr. 2026.

  1. Stratégie de paiements instantanés

    La Banco de la República entreprend de faire interopérer les systèmes de paiement de faible valeur de Colombie via un annuaire central de clés et un règlement en temps réel.

  2. Règles pour les SPBVI

    La banque centrale publie la réglementation des systèmes de paiement de faible valeur interopérables et définit le standard commun de clé (llave).

  3. Les clés, puis l’exploitation complète

    L’enregistrement des clés ouvre à la mi-2025 ; l’exploitation complète suit au second semestre, avec des virements P2P gratuits pour les utilisateurs.

  4. 90 millions de clés

    Plus de 90 millions de clés et 218 entités participantes sont enregistrées, avec plus de 370 millions d’opérations réglées en temps réel depuis le lancement.

Pourquoi Localpayment

Pourquoi utiliser Bre-B avec Localpayment

  • Une API pour les encaissements et les décaissements

    Bre-B utilise la même API que toutes les autres méthodes : POST /api/payin/ pour encaisser, POST /api/payout/ pour décaisser, et de nouveaux marchés par configuration.

  • Statut par webhook pour chaque transaction

    Chaque changement de statut est envoyé à votre endpoint, signé en HMAC-SHA256, pour vérifier et automatiser.

  • Rapprochement dans le Business Portal

    Rapprochez chaque transaction via votre externalId et notre internalId, avec les rapports du Business Portal et les API de solde.

FAQ

Bre-B : questions fréquentes

En combien de temps un paiement Bre-B est-il confirmé ?

Bre-B est un rail en temps réel qui confirme en quelques secondes, 24/7. Pour les encaissements, le statut final vous parvient par webhook signé ; construisez votre parcours de commande autour de cette notification.

Quels sont les plafonds ?

La plage documentée pour les comptes virtuels va de COP 1 à 11 000 000, et les décaissements vers des clés Bre-B atteignent COP 11 552 000. Consultez le tableau des informations clés et confirmez vos plafonds avec votre gestionnaire de compte.

Puis-je encaisser et décaisser avec Bre-B ?

Oui. Vous encaissez via un compte virtuel identifié par une clé Bre-B, et payez les clés Bre-B de vos bénéficiaires en temps réel, 24/7.

Comment la clé Bre-B d’un compte virtuel est-elle construite ?

De façon déterministe à partir du nom de bénéficiaire fourni à la création : préfixe @, LP, les dix premiers caractères du nom et un compteur à quatre chiffres (10 à 16 caractères au total). Il n’est pas possible de choisir une clé arbitraire.

Comment décaisser vers une clé Bre-B ?

Envoyez POST /api/payout/ avec paymentMethod.code 0062, type BankTransfer et flow DIRECT, et placez la clé du destinataire dans beneficiary.bank.account.alias ; omettez le type et le numéro de compte.

Un encaissement Bre-B peut-il être remboursé ?

Oui, intégralement, avec PATCH /api/payin/{externalId}/refund. Les fonds reviennent automatiquement sur le compte d’origine du payeur et l’encaissement se termine en 902 (REFUNDED).

Quels sont les statuts du décaissement ?

100 Received, 101 Locked (conformité validée), 102 In Progress (envoyé à Bre-B), 200 Completed (crédité) et 300 Rejected, chacun transmis par webhook signé.

Ajoutez Bre-B à vos encaissements

Indiquez-nous vos marchés et vos volumes. Vous démarrez avec des identifiants Stage (sandbox) et nous vous accompagnons jusqu’à la mise en production.

Comment pouvons-nous vous aider ?

Téléchargez votre exemplaire

Laissez vos coordonnées et recevez l’édition complète immédiatement.