绑卡结果查询 POST /v1/wallet/account/result

用途：查询功能一/二单笔绑卡请求（merchantRequestNo / walletBizNo）的 聚合终态 及当次绑卡的卡级明细快照；建议在用户跳转 pageUrl 后轮询，并与异步通知配合使用。

与解绑、协议列表的关系（必读）

能力 数据含义 解绑后是否变化
本接口 cards[] 当次绑卡请求的历史快照（「这次绑卡绑了哪张卡」） 否：解绑后仍返回当时记录
绑卡列表查询agreements/query 签约号下当前仍有效的协议列表 是：已解绑协议不再出现
解绑银行卡unbind 解绑指定协议 不影响本接口历史快照
  • 卡管理、展示当前可用卡、解绑后刷新列表 → 用 agreements/query，勿用本接口 cards 代替。
  • 本接口适用于：绑卡当场轮询终态、对账/审计、与异步通知对照。
  • 功能三扣款按 contractNo 查当前有效协议，不会因本接口仍返回已解绑卡而误扣。

Body 字段说明

字段 类型 必填 说明
merchantId string 条件 商户直连必填；统一会员可省略
merchantRequestNo string 条件 与 walletBizNo 二选一
walletBizNo string 条件 与 merchantRequestNo 二选一

响应体字段说明（resBody / body）

字段 类型 说明
walletBizNo string 钱包业务号
bindStatus string SUCCESS / FAIL / PROCESSING；
contractNo string 签约号；bindStatus=SUCCESS 时返回，供功能三扣款
failCode string 失败错误码；仅 bindStatus=FAIL
failMessage string 失败原因；仅 bindStatus=FAIL
cards array 当次绑卡成功的卡信息（展示用）；非当前可用卡全集

实际响应中可能还带 functionType、productRoute 等，判断终态以 bindStatus 为准。

cards[] 商户常用字段：

字段 说明
bankCode 银行编码（如 ICBC）
cardNoMask 脱敏卡号
agreementNo 协议绑定号

处理中响应示例（code=USER_PAYING 由网关/SDK 返回）

{
  "walletBizNo": "4001010120250525120000000001",
  "bindStatus": "PROCESSING"
}

失败响应示例（链接过期）

{
  "walletBizNo": "4001010120250525120000000001",
  "bindStatus": "FAIL",
  "failCode": "WF_004003",
  "failMessage": "绑卡链接已过期"
}

成功响应示例

{
  "walletBizNo": "4001010120250525120000000001",
  "bindStatus": "SUCCESS",
  "contractNo": "C20250525000001",
  "cards": [
    {
      "bankCode": "ICBC",
      "cardNoMask": "6222********1234",
      "agreementNo": "AGR20250525000001"
    }
  ]
}

绑卡处理中的商户规范（建议）

  1. 入口成功拿到 url 后，引导用户完成 cutpayment 绑卡。
  2. 用户回到 pageUrl 后，以 merchantId + merchantRequestNo（或 walletBizNo）调用本接口，间隔 3~5 秒 轮询，建议最长 1~2 分钟（以 expireTime 为上限）。
  3. bindStatus=PROCESSING 或网关/SDK 返回 code=USER_PAYING 时继续轮询；SUCCESS / FAIL 为终态。
  4. 收到异步通知后以通知为准更新本地状态；通知与查询不一致时，以 终态优先 + 幂等更新 处理。
  5. 幂等键：merchantId + merchantRequestNo。