快捷/代扣绑卡申请接口¶
上送持卡人四要素信息(银行卡、户名、证件号、银行留存手机号)进行验证,验证成功后银行会向持卡人的银行留存手机号发送短信验证码
请求参数¶
- 请求地址
https://spin.cloudpnr.com/ssproxy/verifyCardApply
- 公共请求参数
请求报文头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 | |
电子邮箱 | 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公钥加密 |
cert_validity_type | 个人证件有效期类型 | String | Y | 1 | |
cert_begin_date | 个人证件有效期起始日 | String | Y | 8 | |
cert_end_date | 个人证件有效期到期日 | String | C | 8 | 长期有效不填 |
card_mp | 卡绑定手机号 | String | Y | 64 | 需要密文传输,使用汇付RSA公钥加密 |
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 | |
product_id | 产品号 | String | Y | 16 | |
huifu_id | 汇付ID | String | Y | 18 | |
trans_id | 验卡流水号 | String | N | 64 | |
trans_status | 交易状态 | String | Y | 1 | I:初始化,P:处理中,S:成功,F:失败 |
order_id | 订单号 | String | Y | 64 | 一阶段验卡订单号 |
请求示例¶
{
"data":"{\"cert_type\":\"00\",\"expiration \":\"\",\"cert_id\":\"jBlQYnQFLCOllmUpumEAMJlQKPxpAzf2r43VmQFRpOWFQgZ8AzWGwKvsZo3nutqZc8v11aVlEBHiAkYddxg3uOrigc5gk1+JbFkF5YHDRPqciDeI9vgEyka8o3s8Dq4YNs4WSsSXCDySamDeFO+qUiAMkQ+HxpbGbd+zidy5H1g=\",\"cert_begin_date\":\"20100701\",\"card_id\":\"lFGaXTTRfzzWkJm+J4lLT7eEChzukUa/XUOcfXtjklBA8g1lk63U7LISIqsj8Ua7gtmbUuKxHqJoIvuLknfpInn4PE6cMp+I0EEnvbbQyrkNJJse0Mnq+NCWH7qC/LpuxkFSBJ4eettQOpD/SEfyUZVYCcDJkHwxCQWeI0tl77U=\",\"cert_validity_type\":\"1\",\"vip_code\":\"\",\"out_cust_id\":\"6666000103633680\",\"merch_name\":\"测试\",\"order_date\":\"20210706\",\"cert_end_date\":\"20200701\",\"req_seq_id\":\"rQ2021070604081829\",\"card_mp\":\"S0iW0QBI5KtPTP1JC0dIYwqUixx7wWgqDgZc7hBm2q/Puh8OduY42W9gzTTo6rqKamdi89a1kE9d0M5gd8LZYyW6s1lbyCGp6EJpzpZMNmJnfKJA1qQCinHFulAHgAXDxpjTuN/anz6POTibtV6MzvKkkw2S9kN9mgswcFNi2NA=\",\"req_date\":\"20210706\",\"product_id\":\"JCTEST\",\"card_name\":\"JtLXBXBkRQBMhfjaSGEHUDcvmcEYTn6cBKvsPmnwYscJhq+XuERD4lairv47v2CFHH0P5r3KacsOXFB3YBJAEZphI3QB6xQ5qyWCvXl4wNq/TUPXUyck7qNzrGsDLaDqziYmwcDiuwyMzb6BtSNefmNIi77BRCnjLSZHUhsoTzo=\",\"huifu_id\":\"6666000003078984\",\"order_id\":\"202107060408081823540\",\"email\":\"*\"}",
"sys_id":"ssproxy_dev",
"sign":"GgbFXkoKIzBQ8sLHHfPUMJaMp0tg1y0OWXDRxIRO9N8HX5u1K8G27nHWiyDOwXPe9e0eYQFfkV3jF4i+FOf6wYJndt4HAPJ4jrAgfGtpk11+ziVqxz1kFNJyLBJL11eB03veAGnS35KQCLpF/h8+MhogcvQVJ6Pm695MWmFFh8w=",
"sign_type":"RSA2"
}
响应示例¶
- {
- “data”:”{“sub_resp_code”:”00000000”,”req_seq_id”:”rQ2021070604081829”,”product_id”:”JCTEST”,”req_date”:”20210706”,”trans_id”:”202107060408081823540”,”order_id”:”202107060408081823540”,”sub_resp_desc”:”成功”}”, “resp_desc”:”成功调用”, “resp_code”:”10000”, “sign”:”cY3TMXdn2EM7HrZPLWh4VJCVVYhsHrrtNMnWwU5rNj1sHNEU/2vwXAn0RotGSn+hMuIcuOWz36ZgJmT66bdEnOvQRNpd+5cD5ShujvouSW0jVNrWd3tUlpTbRFIEe7E2IVCQ8jCVkkHhdAFQ5keI3euy6k6d6b7PRcdFj1W9dVg=”
}