BREB_QR

BREB 是哥伦比亚央行推动的银行间即时转账体系


支付方式属性

字段名称内容
可用国家代码哥伦比亚(CO)
消费者货币COP
处理货币COP
结算货币美元 (USD)
类型 I银行转账(bankTransfer)
类型 IIbrebkey
退款不支持退款
拒付
集成类型异步

交易流程

  1. 消费者在商家的结账页面选择BREB_QR付款并填写个人信息。
  2. 跳转支付信息页。
  3. 消费者扫描二维码进行付款。
  4. 消费者完成交易。
  5. 消费者被重定向对应页面。

集成

请求参数说明:

参数名类型必填说明
referenceString订单唯一标识
amountObject订单金额信息
├── currencyString货币类型(如 COP)
├── valueNumber金额数值,单位为最小货币单位
productDetailString订单描述
countryCodeString国家代码(如 CO)
originString订单来源,如商城域名
paymentMethodObject支付方式信息
├── shopperEmailString付款人邮箱
├── typeString支付方式(如 nequico)
├── holderNameString姓名
returnUrlString支付完成后返回的 URL
shopperReferenceString付款人唯一标识

交易调用输入示例

{
    "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"
}

响应参数说明

参数名类型必填说明
codeString响应状态码,"0" 表示成功
msgString响应消息
serverTimeNumber服务器时间戳,单位毫秒
dataObject业务数据对象
├── actionObject支付跳转相关信息
│ ├── paymentMethodTypeString支付方式类型(如 brebqr)
│ ├── urlStringWeb 端支付 URL
│ ├── methodString请求方法(如 Get)
│ ├── typeString操作类型(如 qrcode)
│ ├── qrCodeString二维码
├── amountObject订单金额信息
│ ├── currencyString货币类型(如 HKD, USD)
│ ├── valueNumber金额数值,单位为最小货币单位
├── additionalDataString支付附加信息
│ ├── expireTimeString过期时间
├── merchantReferenceString商户订单号
├── pspReferenceString支付平台交易号
├── resultCodeString支付结果状态(如 PENDING)
successBoolean是否成功(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
}

附加信息