绑卡签约申请

报文说明

请求头报文

域名 变量名 必填 备注
商户号 member_id M 宝付提供给商户的唯一编号
终端号 terminal_id M 终端号
交易类型 txn_type M 190
版本号 version M 4.0.0.1
格式 format M 各个接口业务参数的格式化类型,固定值json
字符集 charset M 字符集编码,固定值UTF-8
时间戳 timestamp M 时间戳与宝付支付系统时间误差不超过10分钟,格式为yyyyMMddHHmmss,如:2025年4月15日15点50分12秒表示为:20250415155012
签名类型 sign_type M RSA-国际;SM2-国密
签名证书序列号 sign_sn M 发送方公钥证书序列号,用于接收方验签证书选择
加密证书序列号 ncrptn_sn M 接收方公钥证书序列号,用于接收方解密证书选择
签名字符串 signature M 使用发送方私钥签名的非对称密钥,并做16进制转码
业务数据 data_content M 业务数据报文,JSON格式

请求报文公共格式

member_id=120838,txn_type=181,version=1.0.0,format=json,charset=UTF-8,timestamp=20250618135526,sign_type=RSA,terminal_id=23462,sign_sn=1,ncrptn_sn=1,data_content=【参考业务请求参数示例】,signature=47586A224689881F52F565E56C00E11AC7DD164EB4D2316EC0C47596F21D36EAC42E7122D0AE920249CFA116167EE7F3176688671516524F2341DB74724C198B05B4BA3B48D8A0D46E8B81113EFDF684CC68C5600AF79CB0556E6CE84625AB707262AD8E3D709A42B8C4643E63E0E8E82CE873F5E5DDE32C2727EB471F9F41FB

业务请求参数示例

{
  "acc_info": "c648371cd096394bd247d440b79d39c3cec53819f641ae24fc0ce2316296b62cae7ed57d01a381ca1393072eb73ee7bc6331a58c48bd13b7b0a4e7e31a7a15f0",
  "agent_member_id": "120838",
  "agent_terminal_id": "23462",
  "bank_code": "",
  "card_type": "",
  "dgtl_envlp": "31785009E2B8F260ABBFE91050BB5320BD27AAF47842A070C76FFB90DD891A957D97F788E15D9A5EBC300CA18D32249C088904FD105028D720840DF3B3CED5B156C429F0790373D89838F7497A91286F7CD476D74A5643CDFD1FAF0BEF4E47283E5ABFFA3B8D54D83529A98405E7042965B267039B6F8494E338EAAB3385F0B1",
  "front_fail_url": "https://www.baidu.com/",
  "front_url": "https://www.baidu.com/",
  "member_id": "1235293",
  "notify_url": "https://bf-test-system.baofoo.com/receive/protocolNotice?wx=TXJ001",
  "out_order_no": "e063b577f7d64ad1817aa6ab9e71c599",
  "req_extend_params": "{\"req_param_1\":\"req_param_1\"}",
  "req_reserved1": "req_reserved1",
  "req_reserved2": "req_reserved2",
  "risk_item": "{\"goodsCategory\":\"02\",\"riskRateInfo\":{\"usrLoginMethod\":\"11111\",\"merUserRegDt\":\"20250619160434\",\"deviceID\":\"iphone\"}}",
  "send_time": "2025-06-19 16:04:34",
  "terminal_id": "50009",
  "user_id": "432333199305118713"
}

返回头报文

参数含义 参数名称 必填 参数备注
商户号 member_id M 宝付提供给商户的唯一编号
终端号 terminal_id M 终端号
交易类型 txn_type M 同请求时传入参数
版本号 version M 4.0.0.1
格式 format M 各个接口业务参数的格式化类型,固定值json
字符集 charset M 字符集编码,固定值UTF-8
时间戳 timestamp M 时间戳与宝付支付系统时间误差不超过10分钟,格式为yyyyMMddHHmmss,如:2025年4月15日15点50分12秒表示为:20250415155012
签名类型 sign_type M RSA-国际;SM2-国密
签名证书序列号 sign_sn M 发送方公钥证书序列号,用于接收方验签证书选择
加密证书序列号 ncrptn_sn M 接收方公钥证书序列号,用于接收方解密证书选择
签名字符串 signature M 使用发送方私钥签名的非对称密钥,并做16进制转码
业务数据 data_content M 业务数据报文,JSON格式
响应码 response_code M 当该值为:SUCCESS,则可以取data_content,详见:【响应码
响应信息 response_message M 响应信息

响应报文公共格式

{
    "member_id": "120838",
    "terminal_id": "23462",
    "txn_type": "181",
    "charset": "UTF-8",
    "version": "1.0.0",
    "format": "json",
    "sign_type": "RSA",
    "sign_sn": "1139986924",
    "ncrptn_sn": "1",
    "signature": "7E3FDC3C53A578772785646EA356010D78E9510049B92C8C8DC4E374C1789C3895C45B121F88C833DB5B0643186DAD0975479021D73DE04F53A552EF46F9F919C054D0480F5C3E9A91370E3B14D31A3ED3945200B259CE03920E1FAA348804606B42377967EC3B54E23607598A5EED134064475B866C8C09352B0EA052197D47",
    "data_content": "响应业务参数示例",
    "response_code": "SUCCESS",
    "response_message": "成功"
}

响应业务参数示例

{\"member_id\":\"1235293\",\"terminal_id\":\"50009\",\"agent_member_id\":\"120838\",\"agent_terminal_id\":\"23462\",\"result_code\":\"0000\",\"result_message\":\"交易成功\",\"order_no\":\"250619101010198001147502\",\"out_order_no\":\"e063b577f7d64ad1817aa6ab9e71c599\",\"txn_type\":\"181\",\"order_status\":\"PROCESSING\",\"send_time\":\"2025-06-19 16:04:48\",\"contract_url\":\"https://mcashier.95516.com/mobile/api/unifiedOrderIndex.action?tn=506614796599055474817&sign=37806bc2c75898baaa649d02d58196a57e0e0fd96e78790b2c3d02efcdb415b7\",\"req_reserved1\":\"req_reserved1\",\"req_reserved2\":\"req_reserved2\",\"extend_params\":{}}

通知请求头报文

参数含义 参数名称 必填 参数备注
商户号 member_id M 宝付提供给商户的唯一编号
终端号 terminal_id M 终端号
通知类型 notify_type M 通知类型
版本号 version M 4.0.0.1
格式 format M 各个接口业务参数的格式化类型,固定值json
字符集 charset M 字符集编码,固定值UTF-8
签名类型 sign_type M RSA:11 ;国密SM2: 10
签名证书序列号 sign_sn M 发送方公钥证书序列号,用于接收方验签证书选择
加密证书序列号 ncrptn_sn M 接收方公钥证书序列号,用于接收方解密证书选择
签名字符串 signStr M 使用发送方私钥签名的非对称密钥,并做16进制转码
业务数据 data_content M 业务数据报文,JSON格式

请求报文公共格式

{
  "response_code": "SUCCESS",
  "response_message": "OK",
  "member_id": "120838",
  "terminal_id": "23462",
  "charset": "UTF-8",
  "version": "1.0.0",
  "format": "json",
  "notify_type": "SIGN",
  "sign_type": "RSA",
  "ncrptn_sn": "1",
  "sign_sn": "1139986924",
  "signature": "",
  "data_content": {
    "member_id": 1235293,
    "order_no": "250619101010198001147502",
    "protocol_no": "5e1d8e72d0110c4388a28e46f52a11bedf7ff117f18c5ae338c5c8ad7f1d74b7",
    "bank_code": "BOC",
    "extend_params": {},
    "result_message": "成功",
    "out_order_no": "e063b577f7d64ad1817aa6ab9e71c599",
    "dgtl_envlp": "4B4819E79F6F4113F19758C6B05EBAC6089F7C37E43A95FEDBB988F7FCEF99A6EA5E98E5311ED58310BDD0543AECA8029F1ABB763F0A3A6A198217EF5A8E028E5B8C7BEEB7FD6E12C049D2CAA63D51B154DBFFE6CFB0FFDFD478422222B5ABD612597496E3067E4C3BE526D594D6C8D593712ADAEEA18A13663CBEBB968311EF",
    "agent_member_id": 120838,
    "order_status": "SUCCESS",
    "agent_terminal_id": 23462,
    "send_time": "2025-06-19 16:08:55",
    "protocol_status": "VALID",
    "sgn_acc": "625897******7178",
    "bank_name": "中国银行",
    "result_code": "SUCCESS",
    "terminal_id": 50009,
    "req_reserved1": "req_reserved1",
    "req_reserved2": "req_reserved2"
  }
}

业务请求参数示例

{
  "acc_info": "c648371cd096394bd247d440b79d39c3cec53819f641ae24fc0ce2316296b62cae7ed57d01a381ca1393072eb73ee7bc6331a58c48bd13b7b0a4e7e31a7a15f0",
  "agent_member_id": "120838",
  "agent_terminal_id": "23462",
  "bank_code": "",
  "card_type": "",
  "dgtl_envlp": "31785009E2B8F260ABBFE91050BB5320BD27AAF47842A070C76FFB90DD891A957D97F788E15D9A5EBC300CA18D32249C088904FD105028D720840DF3B3CED5B156C429F0790373D89838F7497A91286F7CD476D74A5643CDFD1FAF0BEF4E47283E5ABFFA3B8D54D83529A98405E7042965B267039B6F8494E338EAAB3385F0B1",
  "front_fail_url": "https://www.baidu.com/",
  "front_url": "https://www.baidu.com/",
  "member_id": "1235293",
  "notify_url": "https://bf-test-system.baofoo.com/receive/protocolNotice?wx=TXJ001",
  "out_order_no": "e063b577f7d64ad1817aa6ab9e71c599",
  "req_extend_params": "{\"req_param_1\":\"req_param_1\"}",
  "req_reserved1": "req_reserved1",
  "req_reserved2": "req_reserved2",
  "risk_item": "{\"goodsCategory\":\"02\",\"riskRateInfo\":{\"usrLoginMethod\":\"11111\",\"merUserRegDt\":\"20250619160434\",\"deviceID\":\"iphone\"}}",
  "send_time": "2025-06-19 16:04:34",
  "terminal_id": "50009",
  "user_id": "432333199305118713"
}

异步通知说明:

  • 异步通知以POST方式访问商户设置的通知URL
  • 商户系统接收到宝付异步通知,并正确的完成相应的业务处理后,须同步返回大写OK字符串<除了OK无任何其他内容>。
  • 由于网络抖动等异常因素以及商户侧未按照约定返回OK,宝付支付系统会多次请求商户侧通知地址,商户系统必须能够正确处理重复的通知。建议商户系统收到通知进行处理时,采用数据锁进行并发控制,检查对应业务数据状态,如未处理,则进行处理,防止多次通知造成资金损失。
  • 宝付支付系统会在未正常收到商户侧返回OK时,将通过重发机制再次通知商户(重发次数 2~10 次,请以第一次收到的支付成功的消息为准,避免进行多次支付),直到商户接收成功或达到最大重发次数为止则不再进行通知,商户应调用订单查询接口确认订单状态。

响应码

状态码 描述
SUCCESS 成功
FAIL 失败

交易URL

测试环境地址:https://vgw.baofoo.com/protocol/gateway
正式环境地址:https://public.baofoo.com/protocol/gateway (后续提供)

业务请求报文

域名 变量名 必填标识 字段类型 备注
商户号 member_id M Max11Numeric 宝付提供给商户的唯一编号
终端号 terminal_id M Max11Numeric 终端号
代理商户号 agent_member_id O Max11Numeric 宝付提供给商户的唯一编号
代理终端号 agent_terminal_id O Max11Numeric 代理商户终端号
报文发送日期时间 send_time M ISODateTime 发送方发出本报文时的机器日期时间,如 2025-03-19 20:19:19
商户订单号 out_order_no M Max32Text 商户订单号
用户ID user_id M Max50Text 用户在商户平台唯一ID
卡类型 card_type O code 卡类型
账户信息 acc_info M Max255Text 格式为:证件姓名|证件号|证件类型, 加密方式:将该Base64转码后,使用数字信封指定的方式和密钥加密
数字信封 dgtl_envlp M Max512Text 对称密钥,签名方式使用RSA时,则对称秘钥使用AES加密。加密方式:Base64转码后使用宝付的公钥加密
格式二:对称密钥,签名方式使用国密时。加密方式:用宝付SM2加密证书公钥加密后转16进制大写
页面通知地址 page_url M Max255Text 签约完成,页面跳转地址,注:地址后不能带参数,带参可能导致银行无法解析
签约结果通知地址 notify_url M Max255Text 宝付签约结果后台异步通知,不可使用前台通知地址/前台失败通知地址作为签约结果通知地址
风控参数字段 risk_item M 不限制 Json格式,详细参数见风控参数字段说明(通用参数、电商、互金消金、航旅、酒店、宝信、游戏、大宗),必送字段:riskRateInfo.merUserRegDt,riskRateInfo.usrLoginMethod,riskRateInfo.deviceID
二级商户域 sub_mer_info C Max255Text Json格式,详见:【二级商户域:sub_mer_info
商户保留域1 req_reserved1 O Max255Text
商户保留域2 req_reserved2 O Max255Text
请求扩展参数 req_extend_params C 不限制 Json格式,该属性里面的字段会根据业务需求增加或减少
二级商户域:sub_mer_info

域名 变量名 必填标识 字段类型 备注
二级商户代码 subMerId M Max30Text
二级商户名称 subMerName M Max40Text 不支持换行符等不可见字符
二级商户简称 subMerAbbr M Max8Text 不支持换行符等不可见字符

业务返回报文

域名 变量名 必填标识 字段类型 备注
商户号 member_id M Max11Numeric 宝付提供给商户的唯一编号
终端号 terminal_id M Max11Numeric 终端号
代理商户号 agent_member_id C Max11Numeric 宝付提供给商户的唯一编号
代理终端号 agent_terminal_id C Max11Numeric 代理商户终端号
报文发送日期时间 send_time M ISODateTime 发送方发出本报文时的机器日期时间,如 2017-12-19 20:19:19
商户订单号 out_order_no M Max32Text 商户订单号
宝付订单号 order_no C Max32Text 宝付订单号
订单状态 order_status M Max16Text 订单状态,详见:【订单状态
业务返回码 result_code M Max16Text 业务应答码,详见:【业务应答码
业务返回说明 result_message M Max16Text
跳转地址 contract_url C Max1024Text 提交跳转地址
返回扩展参数 extend_params C json格式,该属性里面的字段会根据业务返回增加或减少
数字信封 dgtl_envlp C Max512Text 对称密钥,签名方式使用RSA时,则对称秘钥使用AES加密。加密方式:Base64转码后使用宝付的公钥加密
格式二:对称密钥,签名方式使用国密时。加密方式:用宝付SM2加密证书公钥加密后转16进制大写
商户保留域1 req_reserved1 R Max255Text
商户保留域2 req_reserved2 R Max255Text

签约结果异步通知

业务通知报文

域名 变量名 必填标识 字段类型 备注
商户号 member_id M Max11Numeric 宝付提供给商户的唯一编号
终端号 terminal_id M Max11Numeric 终端号
代理商户号 agent_member_id O Max11Numeric 宝付提供给商户的唯一编号
代理终端号 agent_terminal_id O Max11Numeric 代理商户终端号
报文发送日期时间 send_time M ISODateTime 发送方发出本报文时的机器日期时间,如 2025-03-19 20:19:19
业务返回码 result_code M Max16Text 业务应答码,详见:【业务应答码
业务返回说明 result_message M Max255Text
宝付订单号 order_no C Max32Text 宝付则订单号
商户订单号 out_order_no C Max32Text 商户请求订单号
订单状态 order_status M Max16Text 订单状态,详见:【订单状态
签约协议号 protocol_no C Max256Text 只有成功时该字段才有值,加密方式:Base64转码后,使用数字信封指定的方式和密钥加密
账户信息 acc_info C Max256Text 返回格式:证件号|证件姓名|卡号|手机号|卡类型 , 加密方式:将该Base64转码后,使用数字信封指定的方式和密钥加密
协议状态 protocol_status C Max16Text 只有成功时该字段才有值
数字信封 dgtl_envlp C Max512Text 格式:对称密钥,签名方式使用RSA时,则对称秘钥使用AES加密。加密方式:Base64转码后使用宝付的公钥加密
格式二:对称密钥,签名方式使用国密时。加密方式:用商户SM2加密证书公钥加密后转16进制大写
银行卡识别码 sgn_acc C Max256Text 前六后四,中间*补充,只有成功时该字段才有值
银行编码 bank_code C Max16Text 只有在绑卡成功后该字段才有值
银行名称 bank_name C Max32Text 只有在绑卡成功后该字段才有值
商户保留域1 req_reserved1 O Max255Text
商户保留域2 req_reserved2 O Max255Text
返回扩展参数 extend_params C 不限制 Json格式,该属性里面的字段会根据业务返回增加或减少

订单状态

状态码 描述
INIT 初始化
PROCESSING 处理中
SUCCESS 成功
FAIL 失败
CLOSED 关闭

业务应答码

状态码 描述
0000 0000
BF00100 系统异常,请联系宝付
BF00101 持卡人信息有误
BF00113 交易处理中,请稍后查询
BF00114 订单已支付成功,请勿重复支付
BF00116 该终端号不存在
BF00118 报文中密文解析失败
BF00120 报文交易要素缺失
BF00121 报文交易要素格式错误
BF00122 卡号和支付通道不匹配
BF00123 商户不存在或状态不正常,请联系宝付
BF00124 商户与终端号不匹配
BF00125 商户该终端下未开通此类型交易
BF00126 该笔订单已存在
BF00127 不支持该支付通道的交易
BF00128 该笔订单不存在
BF00129 密文和明文中参数【%s】不一致,请确认是否被篡改!”
BF00130 请确认是否发送短信,当前交易必须通过短信验证!
BF00131 当前交易信息与短信交易信息不一致,请核对信息
BF00132 短信验证超时,请稍后再试
BF00133 短信验证失败
BF00134 绑定关系不存在
BF00135 交易金额不正确
BF00136 订单创建失败
BF00180 获取短信验证码失败
BF00182 您输入的银行卡号有误,请重新输入
BF00183 请重新获取验证码
BF00186 该卡已绑定
BF00187 暂不支持信用卡的绑定
BF00188 绑卡失败
BF00190 商户流水号不能重复
BF00331 卡号校验失败
BF00313 该商户未开通此产品
BF00315 手机号码为空,请重新输入
BF00316 ip未绑定,请联系宝付
BF00317 短信验证码已失效,请重新获取
BF00321 身份证号不合法
BF00324 请求计费出现异常
BF00325 交易受理成功
BF00328 商户订单号不能重复
BF00332 收单交易失败
BF00333 收单交易处理中,请稍后查询
BF00399 订单已存在,请勿重复提交
BF00383 商户绑卡同步关系未配置
BF00423 商户暂无权限进行此交易,请联系宝付
BF00455 平台编号不正确
BF00456 该终端未配置签名证书
BF00458 商户订单号格式错误
BF00460 该终端未配置加密证书
BF00462 接口发起商户号与代理商户号不匹配
BF00463 商户未配置计费规则
BF00464 订单创建失败
BF00465 代理商户关系不存在
BF00466 商户未开通相应支付方式
BF00467 绑卡操作失败
BF00468 报文签名失败
BF00469 通知商户失败
BF00470 协议不存在或无效
BF00471 确认支付的订单状态无效
BF00472 请求参数无效
BF00473 签约信息不存在
BF00474 数字证书加密异常
BF00475 您输入的银行编码有误,请重新输入
BF00476 确认支付与预支付订单商户号不匹配
BF00477 商户重复请求
BF00500 渠道返回营销列表为空
BF00501 渠道返回营销余额信息为空
BF00502 渠道支付失败