绑卡签约申请
报文说明
请求头报文
| 域名 |
变量名 |
必填 |
备注 |
| 商户号 |
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 |
渠道支付失败 |