绑卡列表查询 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"
    }
  ]
}