银行卡分期签约¶

调用此接口完成银行卡分期业务的签约。

请求参数¶

请求地址

https://spin.cloudpnr.com/top/bccredit/sign

公共请求参数

请求报文头HEADER - 「接口规则-参数规定-报文头」，请求报文体BODY - 「接口规则-参数规定-报文体」，响应报文体 - 「接口规则-参数规定-响应报文体」

请求参数(data)

参数	中文名	定义	长度	非空	说明
req_seq_id	请求流水号	String	128	Y	请求流水号
req_date	请求时间	String	8	Y	请求时间YYYYMMDD
huifu_id	商户号	String	32	N
bank_no	银行编号	String	8	N	参见附录银行编码
card_name	持卡人姓名	String	60	Y
card_no	银行卡号	String	19	Y
card_mobile	银行卡手机号	String	11	Y
id_type	证件类型	String	2	Y	证件类型 01：身份证
id_no	证件号	String	20	Y
cvv2	CVV2	String	3	N
valid_date	有效期	String	4	N	月年，例：【0120】表明有效期是一直到2020年1月
card_type	卡类型	String	1	N	D:借记卡 C:信用卡 P:存折 Y:预付费卡 V:虚拟账户 Z:借贷合一卡
card_acct_type	银行账户类型	String	1	N	银行卡账户类型 E：对公，P：对私
trans_amt	交易金额	String	12	Y	订单金额，单位元，需保留小数点后两位，例如：1.00,最低传入0.01
time_expire	订单有效期	String	14	N	订单失效时间
terminal_device_info	设备信息	JSON		Y	Json对象，详见设备信息
notify_url	异步通知地址	String	512	N	异步通知地址例：virgo://http://www.xxx.com/getResp
business_url	页面跳转地址	String	120	Y	支付成功后，前端跳转地址
request_type	请求类型	String	1	Y	0:pc 1:安卓 2：ios
place_id	业务地址	String	6	N	6位地区编码，默认200000

响应参数¶

同步响应参数(data)

参数	中文名	定义	长度	非空	说明
sub_resp_code	业务返回码 \| String \| 8			Y	见附录业务返回码
sub_resp_desc	业务返回描述 \| String \| 512			Y	业务返回描述
req_seq_id	业务请求流水号	String	128	Y	业务请求流水号
req_date	业务请求时间	String	8	Y	业务请求时间YYYYMMDD
hf_seq_id	汇付流水号	String	128	Y	汇付流水号
product_id	产品号	String	32	Y
huifu_id	商户号	String	32	N
trans_stat	签约状态	String	1	Y
huifu_sign_no	汇付协议号	String	32	N
form_encoding	页面字符集	String		N	UTF-8、GBK等等
form_html	拼装地址	String	4096	Y	签约提交银行页面html
bank_code	银行返回码	String	65	N
bank_message	银行返回信息	String	256	N

请求示例¶

{
    "sign_type":"RSA2",
    "sys_id":"test",
    "sign": "kP0YeT3BxIRpc0SsrCLRh6ZCKDk/nvJhCCIHb4MSuJacEvkeK8H7QPG+uGegrC92HWtHxFYeoh2csH4sy7IQG9EC1Dh0aKC+r5j/GXb014ZqQBksVMtsSXJpe5JcbMIHfLgdgfWn3SvMsI8Co2BxseC6mC4VQHZDcAc0upoJwqhpsibzm1d+dFVKkLUL5veO1uNhXhPdYx6VSQJbj9MFCh5Vrkf1yc/lvLqGLm5E1ZJjHovMJLNrIBodGkKXO8vB7JtWoTqDN+0eVZFjp9nVO1b7F3CtMABarcpw+v13FjOMAmpkF1ZiYOaHFvHGIaWCVbOvLn2dVXQZsWTCwQvWmA==",
    "data": "{\"business_url\": \"https://xxx.com/callback\",\"card_mobile\": \"18180891234\",\"card_name\": \"xxx\",\"cardNo\": \"***\",\"huifu_id\": \"6666000102123456\",\"id_no\": \"***\",\"id_ype\": \"01\",\"notify_url\": \"virgo://https://xxx.com/h5/qrcode/bandcardsign\",\"req_date\": \"20210321\",\"req_seq_id\": \"20210321111938690516\",\"request_type\": \"1\",\"sys_id\": \"test\",\"terminal_device_info\": {\"devs_id\": \"SPINTP335750301080907\"},\"trans_amt\": \"26400.00\",\"trans_type\": \"WITHHOLD_PAY\"}"
}

响应示例¶

{
            "resp_code":"0000",
            "resp_desc":"成功",
            "sign":"kP0YeT3BxIRpc0SsrCLRh6ZCKDk/nvJhCCIHb4MSuJacEvkeK8H7QPG+uGegrC92HWtHxFYeoh2csH4sy7IQG9EC1Dh0aKC+r5j/GXb014ZqQBksVMtsSXJpe5JcbMIHfLgdgfWn3SvMsI8Co2BxseC6mC4VQHZDcAc0upoJwqhpsibzm1d+dFVKkLUL5veO1uNhXhPdYx6VSQJbj9MFCh5Vrkf1yc/lvLqGLm5E1ZJjHovMJLNrIBodGkKXO8vB7JtWoTqDN+0eVZFjp9nVO1b7F3CtMABarcpw+v13FjOMAmpkF1ZiYOaHFvHGIaWCVbOvLn2dVXQZsWTCwQvWmA=="
            "data":"{\"form_encoding\": \"UTF-8\",\"form_html\": \"返回的签约网页html代码，请使用form_encoding指定的字符集，将其打印至浏览器输出流中。\",\"hf_seqId\": \"002900TOP2B210320130953P348ac13907200000\",\"huifu_id\": \"6666000102123456\",\"req_date\": \"20210321\",\"req_seq_id\": \"20210321111938690516\",\"sub_resp_code\": \"00000100\",\"sub_resp_desc\": \"交易正在处理中\",\"sys_id\": \"test\",\"trans_stat\": \"P\"}"
    }

接口调用实例

Demo参考