绑卡列表查询 POST /v1/wallet/account/agreements
用途:按 contractNo 查询当前仍有效的绑卡协议列表。可用于卡管理展示、解绑后刷新、扣款前核验。
与 绑卡结果查询 区分:绑卡结果的
cards[]是单笔流水快照;本接口反映当前可用卡,解绑后对应agreementNo不再返回。
Body 字段说明
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
merchantId |
string | 条件 | 商户直连必填;统一会员可省略 |
requestId |
string | 否 | 查询请求号 |
contractNo |
string | 是 | 钱包账户签约号 |
响应体字段说明(resBody / body)
| 字段 | 类型 | 说明 |
|---|---|---|
contractNo |
string | 签约号 |
agreements |
array | 协议列表(按 bindOrder 升序) |
agreements[] 商户常用字段:
| 字段 | 说明 |
|---|---|
agreementNo |
协议绑定号;扣款指定卡、解绑时使用 |
bindOrder |
扣款顺序(未指定 agreementNo 时按此升序尝试) |
bankCode |
银行编码 |
cardNoMask |
脱敏卡号(账户侧仅含卡尾号时为 **** + 尾号) |
响应示例
{
"contractNo": "CONTRACT001",
"agreements": [
{
"agreementNo": "AGREEMENT001",
"bindOrder": 1,
"bankCode": "ICBC",
"cardNoMask": "****2020"
}
]
}