本接口用于协议支付银行卡绑定。
https://apis.5upay.com/cashier/bindcard/submit
| 参数名称 | 参数中文名称 | 类型& 长度 | 参数说明 | 是否必填 |
|---|---|---|---|---|
| merchantId | 商户编号 | varchar(9) | 商户在首信易系统的唯一id，可在商户后台查看 | M |
| partnerId | 服务商id | varchar(9) | 服务商在首信易系统的唯一id，可在商户后台查看 | C |
| merchantUserId | 商户会员id | varchar(32) | 可通过传入此参数进行绑卡，每个商户下面唯一，请给每个用户分配一个id用于传入此参数，以便用户下次支付时可用之前绑定过的卡，此项请务必保存 | M |
| mode | 绑卡模式 | 固定值 | STANDARD 标准绑卡 | O |
| EXPRESS 快捷绑卡 | ||||
| 默认为“标准绑卡”，也就是输卡号绑卡，“快捷绑卡”是用户跳转至银行页面完成授权和选卡。 | ||||
| phoneNumber | 预留⼿机号 | varchar(15) | 用户银行卡预留手机号，“标准绑卡”模式时必传。 | C |
| bankCardNumber | 银行卡号 | varchar(50) | 用户银行卡卡号，“标准绑卡”模式时必传 | C |
| bankCode | 银行编码 | 固定值 | 绑卡模式为“快捷绑卡”时必传，参数值见“快捷绑卡支持银行列表.xlsx” | C |
| cardType | 银⾏卡类型 | 固定值 | DEBIT_CARD 借记卡 | C |
| CREDIT_CARD 信用卡 | ||||
| 绑卡模式为“快捷绑卡”时必传 | ||||
| name | 持卡⼈姓名 | varchar(20) | 用户银行卡姓名 | M |
| idCardNum | 身份证号 | varchar(50) | 用户身份证号 | M |
| bindCardCallbackUrl | 回调地址 | varchar(200) | 传入格式如: “https://www.5upay.com/callback.action?test=test”.绑卡完成以后会跳转此链接 | C |
| bindCardNotifyUrl | 通知地址 | varchar(200) | 服务器通知：当订单状态为终态后会向该地址发送通知，该地址可以带参数，如: “https://www.5upay.com/callback.a ction?test=test”.注意：如不填 notifyUrl 的参数值支付成功后您的服 务器将得不到绑卡成功的通知。 | C |
| hmac | 参数签名 | varchar(500) | 商户生成的参数签名结果，获取hmac的方法请参考请求加密流程 | M |
注意：以上参数值中不能包含以下特殊字符 ' " & < > ( ) 空格
| 参数名称 | 参数中文名称 | 参数说明 |
|---|---|---|
| merchantId | 商户编号 | 同请求参数 |
| partnerId | 服务商Id | 同请求参数 |
| merchantUserId | 商户会员id | 同请求参数 |
| bankCardNumber | 卡号掩码 | 卡号掩码 |
| name | 持卡人姓名 | 同请求参数 |
| status | 状态 | SUCCESS 成功(请求成功而不是绑卡成功) |
| REDIRECT 重定向(返回此状态后需要跳转此参数列表中的绑卡重定向地址，后续不需要再进行调用绑卡确认接口) | ||
| ERROR 错误 | ||
| errorMsg | 错误信息 | 错误信息 |
| bindCardRedirectUrl | 绑卡重定向地址 | 当status为REDIRECT，跳转此地址进行绑卡 |
| bindCardId | 绑卡id | 绑卡同步请求成功后返回的绑卡id |
| bindStatus | 银行卡绑定状态 | INIT 初始化 |
| PROCESS 处理中(调用此接口后出现此状态继续调用绑卡确认接口) | ||
| FAIL 失败 | ||
| cardType | 银行卡类型 | DEBIT_CARD 借记卡 |
| CREDIT_CARD 信用卡 | ||
| bankCode | 银行编码 | 见编码表.xlsx |
| hmac | 参数签名 | 首信易生成的参数签名结果，验签过程请参考解密流程 |
| 参数名称 | 参数中文名称 | 参数说明 |
|---|---|---|
| merchantId | 商户编号 | 同请求参数 |
| partnerId | 服务商Id | 同请求参数 |
| merchantUserId | 商户会员id | 同请求参数 |
| bankCardNumber | 卡号掩码 | 卡号掩码 |
| bankCardNumberMd5 | 卡号MD5 | 卡号MD5 |
| name | 持卡⼈姓名 | 用户银行卡姓名 |
| errorMsg | 错误信息 | 错误信息 |
| bindCardId | 绑卡id | 绑卡请求成功后返回的绑卡id，此参数用于调用绑卡查询和下单时接口的bindCardId参数。 |
| bindStatus | 银⾏卡绑定状态 | FAIL 失败 |
| SUCCESS 成功 | ||
| UNBIND 已解绑 | ||
| DISABLE 不可用 | ||
| cardType | 银⾏卡类型 | DEBIT_CARD 借记卡 |
| CREDIT_CARD 信用卡 | ||
| bankCode | 银⾏编码 | 见编码表.xlsx |