快捷/代扣绑卡确认接口¶
持卡人在商户端填写银行短信验证码，完成绑卡确认。收到绑卡成功应答后，商户保存绑卡id。
字段加密方式： 商户请求中，商户使用汇付的RSA公钥加密 ，SPIN使用汇付RSA私钥解密; 商户接受报文中，汇付使用商户的RSA公钥加密，商户使用自有RSA私钥解密;
请求参数¶
- 请求地址
https://spin.cloudpnr.com/ssproxy/verifyCardConfirm
- 公共请求参数
请求报文头HEADER - 「接口规则-参数规定-报文头」 ，请求报文体BODY - 「接口规则-参数规定-报文体」 ，响应报文体 - 「接口规则-参数规定-响应报文体」
- 请求参数(data)
| 参数 | 中文名 | 类型 | 必填 | 最大长度 | 说明 |
|---|---|---|---|---|---|
| req_seq_id | 请求流水号 | String | Y | 128 | 请求流水号 |
| req_date | 请求时间 | String | Y | 8 | 请求时间YYYYMMDD |
| product_id | 产品号 | String | Y | 32 | 固定值产品编号 |
| huifu_id | 汇付Id | String | Y | 18 | 汇付商户号 |
| merch_name | 商户名称 | String | Y | 128 | |
| order_id | 订单号 | String | Y | 64 | 和一阶段验卡订单号保持一致 |
| order_date | 订单日期 | String | Y | 8 | 和一阶段验卡订单日期保持一致 |
| out_cust_id | 顾客用户号 | String | Y | 64 | |
| trans_id | 验卡流水号 | String | N | 64 | 绑卡申请接口返回 |
| card_id | 卡号 | String | Y | 64 | 需要密文传输，使用汇付RSA公钥加密 |
| card_name | 卡姓名 | String | Y | 64 | 需要密文传输，使用汇付RSA公钥加密 |
| cert_type | 证件类型 | String | Y | 64 | 00:身份证 |
| cert_id | 证件ID | String | Y | 64 | 需要密文传输，使用汇付RSA公钥加密 |
| card_mp | 卡绑定手机号 | String | Y | 64 | 需要密文传输，使用汇付RSA公钥加密 |
| verify_code | 验证码 | String | Y | 6 | |
| vip_code | CVV2 | String | C | 3 | 信用卡代扣专用，需要密文传输，使用汇付RSA公钥加密 |
| expiration | 卡有效期 | String | C | 4 | 信用卡代扣专用，格式：MMYY 需要密文传输，使用汇付RSA公钥加密 |
响应参数¶
- 同步响应参数(data)
| 参数 | 中文名 | 类型 | 必填 | 最大长度 | 说明 |
|---|---|---|---|---|---|
| resp_code | 业务返回码 | String | Y | 5 | 业务返回码 |
| resp_desc | 业务返回描述 | String | Y | 512 | 网关返回描述 |
| sign | 签名 | String | Y | 签名，对报文整体签名 | |
| data | 交易响应内容体 | String | N | 返回参数 |
- 响应参数(data)
| 参数 | 中文名 | 类型 | 必填 | 最大长度 | 说明 |
|---|---|---|---|---|---|
| sub_resp_code | 业务返回码 | String | Y | 8 | 业务返回码 |
| sub_resp_desc | 业务返回描述 | String | Y | 512 | 业务返回描述 |
| req_seq_id | 请求流水号 | String | Y | 32 | |
| req_date | 请求日期 | String | Y | 8 | |
| huifu_id | 汇付ID | String | Y | 18 | |
| product_id | 产品号 | String | Y | 16 | |
| trans_status | 交易状态 | String | Y | 1 | I:初始化,P:处理中,S:成功,F:失败 |
| token_no | 卡令牌 | String | N | 20 | 快捷交易使用，卡令牌和cust_id 绑定一起使用，同步返回时， 若交易状态不为成功，该字段返回空 |
| cust_id | 用户号 | String | N | 16 | 快捷交易使用，卡令牌和cust_id 绑定一起使用 |
请求示例¶
{
"data":"{\"req_seq_id\":\"rQ20210706040804\",\"req_date\":\"20210706\",\"huifu_id\":\"6666000003078984\",\"product_id\":\"JCTEST\",\"merch_name\":\"测试\",\"order_id\":\"20210706040808670823540\",\"order_date\":\"20210706\",\"out_cust_id\":\"6666000103633680\",\"trans_id\":\"20210706040808670823540\",\"card_id\":\"lFGaXTTRfzzWkJm+J4lLT7eEChzukUa/XUOcfXtjklBA8g1lk63U7LISIqsj8Ua7gtmbUuKxHqJoIvuLknfpInn4PE6cMp+I0EEnvbbQyrkNJJse0Mnq+NCWH7qC/LpuxkFSBJ4eettQOpD/SEfyUZVYCcDJkHwxCQWeI0tl77U=\",\"card_name\":\"JtLXBXBkRQBMhfjaSGEHUDcvmcEYTn6cBKvsPmnwYscJhq+XuERD4lairv47v2CFHH0P5r3KacsOXFB3YBJAEZphI3QB6xQ5qyWCvXl4wNq/TUPXUyck7qNzrGsDLaDqziYmwcDiuwyMzb6BtSNefmNIi77BRCnjLSZHUhsoTzo=\",\"cert_type\":\"00\",\"cert_id\":\"jBlQYnQFLCOllmUpumEAMJlQKPxpAzf2r43VmQFRpOWFQgZ8AzWGwKvsZo3nutqZc8v11aVlEBHiAkYddxg3uOrigc5gk1+JbFkF5YHDRPqciDeI9vgEyka8o3s8Dq4YNs4WSsSXCDySamDeFO+qUiAMkQ+HxpbGbd+zidy5H1g=\",\"verify_code\":\"111111\",\"card_mp\":\"S0iW0QBI5KtPTP1JC0dIYwqUixx7wWgqDgZc7hBm2q/Puh8OduY42W9gzTTo6rqKamdi89a1kE9d0M5gd8LZYyW6s1lbyCGp6EJpzpZMNmJnfKJA1qQCinHFulAHgAXDxpjTuN/anz6POTibtV6MzvKkkw2S9kN9mgswcFNi2NA=\",\"vip_code\":\"\",\"expiration \":\"\"}",
"sysId":"ssproxy_dev",
"sign":"iC/qP6FaAPpF53QBvDtVphBnmUUzHD/DgS3Ezjt9u3DswkCFEOjANsUNI73Yul+f6oP+vJXmAPi+o9LNXkupMwzLEiGZrWA4enE1QOPckwujLIIGYhUSWVR+0XumcAaGNVv3Na2lF2nCh5gkHhIR5QAni3fb5ilVG2R8/Wpc0pM=",
"signType":"RSA2"
}
响应示例¶
{
"data":"{\"token_no\":\"10000077841\",\"sub_resp_code\":\"00000000\",\"req_seq_id\":\"rQ20210706040804\",\"product_id\":\"JCTEST\",\"req_date\":\"20210706\",\"huifu_id\":\"6666000003078984\",\"cust_id\":\"6666000103791841\",\"sub_resp_desc\":\"成功\",\"trans_status\":\"S\"}",
"resp_code":"10000",
"resp_desc":"成功调用",
"sign":"W7cWDa7Mtpj8BDfxrY0IMi7DJsl+ommer3kHEwPYzdn/xsjbfliEtcpEafmpxUd7P4q8Z4nmAs42uMWoAJDOowqbTUCtubmntUhPeukipxPD4NKIEdD4WIbH+UuwNMIS4E0Zcnak3O6tBn1+oJeNnZY/dcqdrdbi6Z0OIU8bxnk="
}
