绑卡查询

功能概述

本接口用于确认协议支付银行卡绑定状态。注:查询接口有每分钟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

注意:以上参数值中不能包含以下特殊字符 ' " & < > ( ) 空格

参数示例

{ "hmac": null, "merchantId": "100000050", "bindCardId ": "959e138ad2e290328e8d59fd124c618f ", "merchantUserId": "123456" }

请求同步返回参数列表

参数名称 参数中文名称 参数说明
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 参数签名 首信易生成的参数签名结果,验签过程请参考解密流程

参数示例

{ "merchantId": "100000050", "merchantUserId": "1234", "bankCardNumber": "621483***1111", "bankCardNumberMd5": "50c1d9e25b24e64bf7f32de761956966", "name": "张三", "status": "SUCCESS", "bindCardId": "959e138ad2e290328e8d59fd124c618f ", "bindStatus": " SUCCESS", "cardType": "DEBIT_CARD", "bankCode": " CCB", "hmac": null }