交互流程
交易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)时必返回,在“签名方式”为国际算法时如请求时上送则返回。