钱包账户绑卡列表查询接口
功能概述
商户通过该接口可以查询钱包账户绑定的银行卡列表。
接口地址
https://webox-api.5upay.com/webox/bindcard/bindCardRecordList
| 参数名称 |
参数中文名称 |
类型& 长度 |
参数说明 |
是否必填 |
| merchantId |
商户编号 |
varchar(9) |
商户在首信易系统的唯一 id，可在商户后台查看 |
M |
| requestId |
订单编号 |
varchar(50) |
提交的订单号必须在账户交易中唯一；首信易数据支付系统中对于已创建的订单，商户端不能重复提交 |
M |
| walletId |
钱包 ID |
varchar(19) |
用户钱包在我司的唯一编号 |
M |
| hmac |
参数签名 |
varchar(500) |
商户生成的参数签名结果，获取hmac的方法请参考请求加密流程 |
M |
参数示例
<![CDATA[
{
"hmac":
"BcMKMTCLWttZEiTnLdeU8UBXTvXdoq4Gkivd3D3vi9bc9SckonT6OEsotZ/tQkZ0ng3keTEQx/JH3YeF4NXcnThwMq+zlHE
j7e3RAM9EKTlGVew8HnojlkrflhA388Cfd2lq2KYGlDb+pzWdaD+FhHbJ7GJfyWEibdEfiTqETrGd0RBFW3CWvwT8F9OqHhc
BRs1jg42QqSe4HfHQYyCYLANs28kTcMLqcxNzh25LgyWuKZwhPjhsKRaObSRfCHbuDnI/8bniu3eXqzlEzwpelOeSeuJl5Ta
CEEvXB5Eq1+w8L6fKVP1is/Gun618N3yWLzBazWEbIGpz7Gqgl6qH3Q==",
"merchantId": "890000593",
"requestId": "20228***3017655",
"walletId": "628****13687",
}
]]>
同步返回参数列表
| 参数名称 |
参数中文名称 |
参数说明 |
| merchantId |
商户编号 |
同请求参数 |
| requestId |
订单号 |
同请求参数 |
| walletId |
钱包 ID |
同请求参数 |
| status |
响应状态 |
SUCCESS 响应正常
FAIL 响应异常
|
| bankCardList |
银行卡列表 |
银行卡列表，见下表 |
| code |
错误编码 |
错误编码 |
| errorMessage |
错误信息 |
错误信息 |
| hmac |
参数签名 |
商户生成的参数签名结果，获取hmac的方法请参考请求加密流程 |
银行卡列表（bankCardList）
| 参数名称 |
参数中文名称 |
参数说明 |
| bankCode |
银行编码 |
银行编码 |
| bankCardNumberDesc |
卡号掩码 |
卡号掩码 |
| serialNumber |
绑卡序列号 |
绑卡序列号 |
| bankCardType |
卡类型 |
卡类型 |
| bankName |
银行名称 |
银行名称 |
| bankCardNumberMd5 |
银行卡号MD5值 |
银行卡号MD5值 |
| id |
微包绑卡id |
微包绑卡id |
| createDateTime |
创建时间 |
绑卡创建时间，格式：yyyy-MM-dd HH:mm:ss |
参数示例
<![CDATA[
{
"bankCardList": [
{
"bankCode": "SHB",
"bankCardNumberDesc": "620***6747",
"serialNumber": "20230316328184821029820950532096",
"bankCardType": "DEBIT_CARD",
"bankName": "上海银行",
"bankCardNumberMd5": "58dab2188d2802742915464390d401d1",
"id": "8a8989bc86c5e61f0186e92506210228",
"createDateTime": "2023-03-16 14:39:23"
}],
"walletId": "5200008020000004372",
"merchantId": "896668917",
"requestId": "1678958638424",
"hmac": "KQ6bz//4hBe/M5Zt8LHfpkmBx+jtr/Az9cwb34qwuQO9BHDa2Akpv2z1nB+HbnZy0dYnLWLU51hqS1j/Cc/KC5
IF2geDTS+J0LyG7vHoAixrFRHToaGh7KCxQf5XC7IPNIwnoeqOzBGq111wk2tGB8qaXKqo5vHJp6oDa1q318M0aAIH2fAV7
crKfxFooEu1yFPnTwFMqNId6mtq+82pZG8E6+61PnfQLFudYyOHmeppMSb7Et2h/fvA3wYU55tM5OSSY/S3RyTVSA+YjW8C
/s9AUQGwKv74C8nliPo1tyqnDG8MIZKAV+ol/TuD4Wgdo9xVHMVHrd2Gfgk6UrYmOA==",
"status": "SUCCESS"
}
]]>