本接口用于确认协议支付银行卡绑定状态。注:查询接口有每分钟200次的限制,超过此限制会报错。
https://apis.5upay.com/cashier/bindcard/query
参数名称 | 参数中文名称 | 类型& 长度 | 参数说明 | 是否必填 |
---|---|---|---|---|
merchantId | 商户编号 | varchar(9) | 商户在首信易系统的唯一id,可在商户后台查看 | M |
merchantUserId | 商户会员id | varchar(32) | 绑卡接口发起时,商户给用户分配的唯一会员id。 | M |
bindCardId | 绑卡id | varchar(50) | 绑卡请求成功后返回的绑卡id | M |
partnerId | 服务商id | varchar(9) | 服务商在首信易系统的唯一id,可在商户后台查看 | C |
hmac | 参数签名 | varchar(500) | 商户生成的参数签名结果,获取hmac的方法请参考请求加密流程 | M |
注意:以上参数值中不能包含以下特殊字符 ' " & < > ( ) 空格
参数名称 | 参数中文名称 | 参数说明 |
---|---|---|
merchantId | 商户编号 | 同请求参数 |
partnerId | 服务商Id | 同请求参数 |
merchantUserId | 商户会员id | 同请求参数 |
bankCardNumber | 卡号掩码 | 卡号掩码 |
bankCardNumberMd5 | 卡号MD5 | 卡号MD5 |
name | 持卡人姓名 | 用户银行卡姓名 |
status | 请求状态 | SUCCESS 成功 |
ERROR 错误 | ||
errorMsg | 错误信息 | 错误信息 |
bindCardId | 绑卡id | 同请求参数 |
bindStatus | 银行卡绑定状态 | SUCCESS 成功 |
DISABLE 不可用 | ||
cardType | 银行卡类型 | DEBIT_CARD 借记卡 |
CREDIT_CARD 信用卡 | ||
bankCode | 银⾏编码 | 见编码表.xlsx |
hmac | 参数签名 | 首信易生成的参数签名结果,验签过程请参考解密流程 |