支付方式 · 哥伦比亚
Bre-B 哥伦比亚：即时收款与付款
为每位客户分配带专属 Bre-B 密钥的虚拟账户以收款，并全天候实时向收款人的 Bre-B 密钥付款。
- 即时转账
- 哥伦比亚
- 收款 · 付款
即时转账虚拟账户
客户 #000123
Bre-B 密钥
@COMERCIO••4821
- Bre-B · ref 7F2A009309:41COP 3,450,000已对账
- Bre-B · ref 3B7Q021109:12COP 980,000已对账
- Bre-B · ref 9A1C1189昨天COP 8,200,000已对账
关键数据
Bre-B 上线数月后
数据归属于哥伦比亚共和国银行。
90 百万
在 DICE 中注册的密钥 (超过, 2026年1月)
33 百万
已关联 Bre-B 的客户 (2026年1月)
218
参与机构 (2026年1月)
6–8
典型交易完成时间 (秒, 2026年5月)
简介
哥伦比亚的即时支付通道
Bre-B 是哥伦比亚的即时支付系统，由哥伦比亚共和国银行（Banco de la República）于 2025 年 10 月 6 日推出。资金可在数秒内完成账户间转移，不受时间限制。在 Localpayment，您可以两种方式使用它：通过由 Bre-B 密钥标识的虚拟账户收款，以及向收款人的 Bre-B 密钥付款。
- 由 Bre-B 密钥标识的虚拟账户（代码 2006）
- 向密钥收款，全天候，webhook 确认
- 全天候实时向 Bre-B 密钥付款（代码 0062）
虚拟账户
客户 #000123
Bre-B 密钥
@COMERCIO••4821
- Bre-B · ref 7F2A009309:41COP 3,450,000已对账
- Bre-B · ref 3B7Q021109:12COP 980,000已对账
- Bre-B · ref 9A1C1189昨天COP 8,200,000已对账
工作原理
Bre-B 转账收款流程
参与方和步骤遵循文档中的流程。最终状态始终通过签名 webhook 送达。
- 1
您的企业Localpayment:
创建虚拟账户
调用 POST /api/virtual-account，可单个或批量创建。本地格式的账号或密钥，可直接分享。
- 2
您的企业付款人:
向付款人提供付款信息
展示在您的收银台、账单或 App 中。
- 3
付款人银行 · Bre-B:
通过银行转账
仅支持电子转账，现金存款不会入账。
- 4
Localpayment您的企业:
Webhook：已收到付款
Localpayment 自动将转账与虚拟账户匹配。签名 webhook 包含付款人信息和金额，资金记入您的 Localpayment 余额。
示意图已简化。时效取决于支付通道和银行，详见下方关键信息。
工作原理
Bre-B 付款流程
参与方和步骤遵循文档中的流程。最终状态始终通过签名 webhook 送达。
- 1
您的企业Localpayment:
发起付款请求
调用 POST /api/payout/，传入收款人信息、金额和 externalId。执行合规检查；启用 requireAuth 时，需第二位审批人签批后才会划转资金。
- 2
Localpayment银行 · Bre-B:
锁定资金并发送指令
付款经 Bre-B 从 Locked 变为 In Progress。
- 3
银行 · Bre-B收款人:
入账至收款人
时效取决于支付通道，详见下方关键信息。
- 4
Localpayment您的企业:
Webhook：付款已完成
Localpayment 将付款更新为最终状态。签名 webhook 返回最终状态，并可下载付款凭证。
示意图已简化。时效取决于支付通道和银行，详见下方关键信息。
工作原理
Bre-B 实际体验
简化的虚构演示，名称和金额仅为示例。
- 1Comercio Ejemplo收银台显示用于支付 COP 185,000.00 的账户信息。
- 2Banco Ejemplo付款人向所示账户转账 COP 185,000.00。
- 3付款成功您的系统收到签名 webhook 并放行订单。
关键信息
Bre-B：关键信息
国家
- 详情
- 🇨🇴 哥伦比亚
币种
- 详情
- COP
方向
- 详情
- 收款与付款
收款 · 虚拟账户（Bre-B 密钥）
- 详情
- 实时到账，通过 webhook 确认 · COP 1 – 11,000,000
付款 · Bre-B 密钥
- 详情
- 实时，7×24 小时 · COP 1 – 11,552,000
摘自 Localpayment 各国文档。限额和可用性可能变化，请与您的客户经理确认。
用户体验
客户使用 Bre-B 时的体验
授权方式、限额和退款均依据 docs.localpayment.com；仅在文档明确说明时才显示限额。
客户如何授权
结账页展示创建虚拟账户时生成的 Bre-B 密钥，例如 @LPTechColomb0001。客户打开银行 App，选择“按密钥转账”，输入密钥和金额并确认。转账实时结算，资金完全入账后触发 webhook。
文档中的限额
虚拟账户（Bre-B 密钥） (收款): COP 1 – 11,000,000 · Bre-B 密钥 (付款): COP 1 – 11,552,000. 按单笔计，依据已发布文档；合同限额可能不同。
退款与退回
已入账的转账可通过 PATCH /api/payin/{externalId}/refund 退款。仅支持全额退款，资金自动退回付款人的原账户，无需额外收款人信息。现金存款不会入账。
集成清单
五步上线 Bre-B
所有通道流程一致。开发前先观看该国的动画结账演示。
获取 Stage 凭证
申请接入，获取沙盒凭证，并通过 POST /api/token/ 获取 JWT。
创建收款
调用 POST /api/payin/，传入关键信息表中的 Localpayment 代码、ISO-3 国家、币种、金额和付款人信息。
展示支付指引
根据响应展示二维码、代码、跳转或账户信息，并遵守有效期。
校验 webhook
验证 x-Signature（HMAC-SHA256），在状态 200 时放行订单，并按 externalId 去重。
观看动画结账演示
在结账体验画廊中逐屏查看该国的每种支付方式。
发展历程
哥伦比亚如何建成互通的即时支付通道
来源：哥伦比亚共和国银行，《Bre-B：哥伦比亚互通即时支付系统》技术文件，2026 年 2 月。
即时支付战略
哥伦比亚共和国银行决定通过中央密钥目录和实时结算，使哥伦比亚的小额支付系统实现互通。
SPBVI 规则
央行发布互通小额支付系统的监管规定，并定义统一的密钥（llave）标准。
先注册密钥，后全面运行
密钥注册于 2025 年年中开放；下半年全面运行，终端用户的 P2P 转账免费。
9000 万个密钥
已注册超过 9000 万个密钥和 218 家参与机构，自上线以来实时结算超过 3.7 亿笔业务。
为什么选择 Localpayment
为什么通过 Localpayment 使用 Bre-B
一个 API 处理收款与付款
Bre-B 与其他所有支付方式使用同一个 API：POST /api/payin/ 收款，POST /api/payout/ 付款，新增市场只需配置。
每笔交易均通过 webhook 推送状态
每次状态变更都会推送至您的接口并使用 HMAC-SHA256 签名，便于校验和自动化。
在 Business Portal 中对账
通过您的 externalId 和我们的 internalId 对账每笔交易，并提供 Business Portal 报表和余额 API。
常见问题
Bre-B 常见问题
Bre-B 付款多久确认？
Bre-B 是实时通道，可在数秒内确认，全天候运行。收款的最终状态会通过签名 webhook 通知您，请以该通知驱动订单流程。
限额是多少？
文档中的虚拟账户范围为 COP 1 至 11,000,000，向 Bre-B 密钥付款最高 COP 11,552,000。请参阅上方关键信息表，并与客户经理确认您的限额。
可以用 Bre-B 同时收款和付款吗？
可以。您通过由 Bre-B 密钥标识的虚拟账户收款，并全天候实时向收款人的 Bre-B 密钥付款。
虚拟账户的 Bre-B 密钥如何生成？
根据创建时传入的收款人名称确定性生成：前缀 @、LP、名称前十个字符和四位计数器（共 10 至 16 个字符）。不能自定义任意密钥。
如何向 Bre-B 密钥付款？
调用 POST /api/payout/，paymentMethod.code 为 0062、type 为 BankTransfer、flow 为 DIRECT，并将收款人密钥填入 beneficiary.bank.account.alias；省略账户类型和账号。
Bre-B 收款可以退款吗？
可以全额退款：调用 PATCH /api/payin/{externalId}/refund。资金自动退回付款人原账户，收款以 902（REFUNDED）结束。
付款有哪些状态？
100 Received、101 Locked（通过合规）、102 In Progress（已发送至 Bre-B）、200 Completed（已入账）和 300 Rejected，均通过签名 webhook 送达。