BREB_QR
BREB 是哥伦比亚央行推动的银行间即时转账体系
支付方式属性
| 字段名称 | 内容 |
|---|---|
| 可用国家代码 | 哥伦比亚(CO) |
| 消费者货币 | COP |
| 处理货币 | COP |
| 结算货币 | 美元 (USD) |
| 类型 I | 银行转账(bankTransfer) |
| 类型 II | brebkey |
| 退款 | 不支持退款 |
| 拒付 | 无 |
| 集成类型 | 异步 |
交易流程
- 消费者在商家的结账页面选择BREB_QR付款并填写个人信息。
- 跳转支付信息页。
- 消费者扫描二维码进行付款。
- 消费者完成交易。
- 消费者被重定向对应页面。
集成
请求参数说明:
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
reference | String | 是 | 订单唯一标识 |
amount | Object | 是 | 订单金额信息 |
├── currency | String | 是 | 货币类型(如 COP) |
├── value | Number | 是 | 金额数值,单位为最小货币单位 |
productDetail | String | 是 | 订单描述 |
countryCode | String | 是 | 国家代码(如 CO) |
origin | String | 是 | 订单来源,如商城域名 |
paymentMethod | Object | 是 | 支付方式信息 |
├── shopperEmail | String | 是 | 付款人邮箱 |
├── type | String | 是 | 支付方式(如 nequico) |
├── holderName | String | 是 | 姓名 |
returnUrl | String | 是 | 支付完成后返回的 URL |
shopperReference | String | 是 | 付款人唯一标识 |
交易调用输入示例
{
"amount": {
"currency": "CO",
"value": 1000
},
"countryCode": "CO",
"origin": "fffmall.com",
"paymentMethod": {
"shopperEmail": "[email protected]",
"holderName": "JW L",
"taxType": "PPT",
"personalTaxId": "36570630563",
"type": "brebkey",
"telephoneNumber": "575555555555"
},
"productDetail": "ljwtest",
"productName": "WEWQ",
"reference": "ljw1769658309659",
"returnUrl": "https://www.baidu.com/",
"shopperReference": "LLL3211321",
"webhookUrl": "https://develop.futureshop.global/api/checkout/payment/123"
}响应参数说明
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
code | String | 是 | 响应状态码,"0" 表示成功 |
msg | String | 是 | 响应消息 |
serverTime | Number | 是 | 服务器时间戳,单位毫秒 |
data | Object | 是 | 业务数据对象 |
├── action | Object | 是 | 支付跳转相关信息 |
│ ├── paymentMethodType | String | 是 | 支付方式类型(如 brebqr) |
│ ├── url | String | 是 | Web 端支付 URL |
│ ├── method | String | 是 | 请求方法(如 Get) |
│ ├── type | String | 是 | 操作类型(如 qrcode) |
│ ├── qrCode | String | 是 | 二维码 |
├── amount | Object | 是 | 订单金额信息 |
│ ├── currency | String | 是 | 货币类型(如 HKD, USD) |
│ ├── value | Number | 是 | 金额数值,单位为最小货币单位 |
├── additionalData | String | 是 | 支付附加信息 |
│ ├── expireTime | String | 是 | 过期时间 |
├── merchantReference | String | 是 | 商户订单号 |
├── pspReference | String | 是 | 支付平台交易号 |
├── resultCode | String | 是 | 支付结果状态(如 PENDING) |
success | Boolean | 是 | 是否成功(true 表示成功) |
交易调用输出示例
{
"code": "0",
"msg": "success",
"serverTime": 1769667959668,
"data": {
"action": {
"paymentMethodType": "brebqr",
"method": "Get",
"type": "qrcode",
"qrCode": "00020101021126320014CO.COM.CRB.LLA0410@CBZDDJ5I149250014CO.COM.CRB.RED0103CRB520400005303170540511.125802CO5918PEXTO COLOMBIA SAS6006BOGOTA610611022181250015CO.COM.CRB.CIVA01020382260014CO.COM.CRB.IVA01040.0083270015CO.COM.CRB.BASE01040.0084250015CO.COM.CRB.CINC01020385260014CO.COM.CRB.INC01040.0090430016CO.COM.CRB.TRXID0119P112559d60848223bdf91860014CO.COM.CRB.SEC01646205ce14f90a055bc87456f7794ff17918ea59b722ecca7aff4e78d12e82ea6280290016CO.COM.CRB.CANAL0105ECOMM6304CF15"
},
"additionalData": {
"expireTime": "2026-01-29T06:30:55Z"
},
"amount": {
"currency": "USD",
"value": 30
},
"merchantReference": "ljw1769667874603",
"pspReference": "2016759383987453952",
"resultCode": "PENDING",
"providerReference": "mm_TKQo6ggG9nILr2"
},
"success": true
}附加信息
无
Updated 2 days ago