绑卡列表查询

基本定义

方法：POST
路径：/v1/wallet/account/agreements
Content-Type：application/json
Auth：统一网关
Timeout：5000ms（建议）
描述：按 contract_no 查询当前有效的绑卡协议列表

请求字段

字段	类型	必填	约束	说明
`contract_no`	string	是	最长 32	钱包账户签约号

请求示例：

{
  "contract_no": "CONTRACT001"
}

响应字段

字段	类型	必填	说明
`contract_no`	string	是	签约号
`card_agreement_list`	array	是	协议列表（按 `bind_order` 升序）；无卡时为 `[]`

card_agreement_list[] 元素：

字段	类型	必填	说明
`agreement_no`	string	是	协议绑定号
`bind_order`	integer	是	扣款顺序（升序尝试）
`bank_code`	string	否	银行编码
`bank_card_type`	string	否	卡类型，如 `D`/`C`
`bank_card_no_masked`	string	否	脱敏卡号；账户侧 `cardNoMask` 原样透传，格式如 `****5661`

响应示例：

{
  "contract_no": "CONTRACT001",
  "card_agreement_list": [
    {
      "agreement_no": "AGREEMENT001",
      "bind_order": 1,
      "bank_code": "ICBC",
      "bank_card_type": "D",
      "bank_card_no_masked": "****5661"
    }
  ]
}

错误与调用方处理

HTTP	网关 `code`	触发条件	调用方处理	可重试
`200`	—	查询成功（含 `card_agreement_list=[]` 无有效协议）	无卡时勿发起扣款；有卡可用于 HTTP-007	否
非 `200`	`INVALID_PARAMETER`	`contract_no` 缺失或超长；Header 缺失	修正参数	是
非 `200`	`UPSTREAM_TIMEOUT`	查询异常	稍后重试	是
非 `200`	`SYSTEM_ERROR`	系统异常	稍后重试	是

空列表不是错误：签约号有效但当前无绑卡协议时返回 card_agreement_list: []。