交易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
银行编号 bank_code C Max10Text 银行编号，见附录；商户自身页面选择银行时必传，银行编号与卡类型必须同时为空或必传
卡类型 card_type C code 卡类型，见附录；商户自身页面选择银行时必传，银行编号与卡类型必须同时为空或必传
账户信息 acc_info M Max255Text 格式为：证件姓名|证件号|证件类型|手机号, 加密方式：将该Base64转码后，使用数字信封指定的方式和密钥加密
数字信封 dgtl_envlp M Max512Text 对称密钥，签名方式使用RSA时，则对称秘钥使用AES加密。加密方式：Base64转码后使用宝付的公钥加密
格式二：对称密钥，签名方式使用国密时。加密方式：用宝付SM2加密证书公钥加密后转16进制大写
前台通知地址 front_url M Max255Text 签约完成，页面跳转地址,注：地址后不能带参数，带参可能导致银行无法解析
前台失败通知地址 front_fail_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
返回扩展参数
域名 变量名 必填标识 字段类型 备注
银联受理订单号 tn C Max21Text 用于后续拉起控件完成签约
云闪付小程序 id cqp_mp_app_id C Max32Text 云微小程序签约场景出现，用于商户跳转进行签约
云闪付小程序path cqp_mp_path C Max1024Text 云微小程序签约场景出现，用于商户跳转进行签约

订单状态

状态码 描述
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 渠道支付失败