交互流程


交易URL


测试环境地址:

正式环境地址:

请求报文

序号 域名 变量名 必填标识 字段类型 备注
1 报文发送日期时间 send_time M ISODateTime 发送方发出本报文时的机器日期时间,如 2017-12-19 20:19:19
2 报文流水号 msg_id M Max32Text 商户流水号
3 报文编号/版本号 version M Max7Text 4.0.0.0
4 终端号 terminal_id M Max11Numeric
5 交易类型 txn_type M code 固定值
6 商户号 member_id M Max11Numeric 宝付提供给商户的唯一编号
7 数字信封 dgtl_envlp M Max512Text 格式:01|对称密钥,01代表AES加密方式:Base64转码后使用宝付的公钥加密
8 用户ID user_id M Max50Text 用户在商户平台唯一ID
9 账户信息 acc_info M Max200Text 格式:持卡人姓名|证件号 加密方式:Base64转码后,使用数字信封指定的方式和密钥加密
9 页面返回地址 page_url M Max255Text 签约完成,页面跳转地址
10 签约结果通知地址 return_url M Max255Text 宝付后台异步通知,在此签约结果处理,不可使用页面返回地址作为签约结果通知地址
11 商户保留域1 req_reserved1 O Max255Text
12 商户保留域2 req_reserved2 O Max255Text
13 系统保留域1 additional_info1 O Max255Text
14 系统保留域2 additional_info2 O Max255Text
15 签名域 signature M Max512Text
16 验签方式 verify_type O Max20Text 示例值:10;国密此字段必传
17 加密证书序列号 ncrptn_sn O Max20Text 接收方公钥证书序列号
18 签名证书序列号 sign_sn O Max512Text 发送方公钥证书序列号
  • 说明
    1)“签名方式”
    “签名方式”用于标识算法方式,国密方式取值为:10;国际算法可默认不传。默认不传为国际算法。
    2)“加密证书序列号”“签名证书序列号”
    “加密证书序列号”和“签名证书序列号”在“签名方式”为国密方式(取值为10)时,必须上传,在“签名方式”为国际算法时,可传可不传。

返回报文

序号 域名 变量名 必填标识 字段类型 备注
1 报文发送日期时间 send_time M ISODateTime 发送方发出本报文时的机器日期时间,如 2017-12-19 20:19:19
2 应答报文流水号 msg_id M Max32Text 宝付的流水号
3 报文编号/版本号 version M Max7Text 4.0.0.0
4 应答码 resp_code M 参见商户接口应答码
5 终端号 terminal_id M Max11Numeric
6 交易类型 txn_type M code 固定值
7 商户号 member_id M Max11Numeric 宝付提供给商户的唯一编号
8 业务返回码 biz_resp_code M Max11Numeric 具体参见附录1:业务应答码
9 业务返回说明 biz_resp_msg M Max11Numeric
10 url地址 url M Max512Text 一键多绑跳转地址
11 数字信封 dgtl_envlp M Max512Text 格式:01|对称密钥,01代表AES加密方式:Base64转码后使用商户的公钥加密
12 商户保留域1 req_reserved1 O Max255Text
13 商户保留域2 req_reserved2 O Max255Text
14 系统保留域1 additional_info1 O Max255Text
15 系统保留域2 additional_info2 O Max255Text
16 签名域 signature M Max512Text
17 加密证书序列号 ncrptn_sn O Max20Text 接收方公钥证书序列号
18 签名证书序列号 sign_sn O Max512Text 发送方公钥证书序列号

-说明
1)“加密证书序列号”“签名证书序列号”
“加密证书序列号”和“签名证书序列号”在“签名方式”为国密方式(取值为10)时必返回,在“签名方式”为国际算法时如请求时上送则返回。