基本定义

  • 方法：POST
  • 路径：/v1/wallet/account/result
  • Content-Type：application/json
  • Auth：统一网关
  • Timeout：5000ms（建议）
  • 查询键：out_trade_no 或 trade_no（至少传一个）
  • 描述：查询绑卡结果快照

请求字段

字段 类型 必填 约束 说明
out_trade_no string 条件 最长 64；与 trade_no 二选一 商户订单号（绑卡时生成的商户订单号）
trade_no string 条件 最长 64；与 out_trade_no 二选一 平台交易号（绑卡时生成的平台交易号）

请求示例：

{
  "out_trade_no": "MCH202505250001"
}

响应字段（分支 A：成功 bind_status=SUCCESS）

HTTP 200。

字段 类型 必填 说明
trade_no string 是 平台交易号
bind_status string 是 固定 SUCCESS
contract_no string 是 签约号
bank_card_list array 否 当次绑卡成功的卡快照（非当前可用卡全集）

bank_card_list[] 元素：

字段 类型 必填 说明
bank_code string 否 银行编码
bank_card_type string 否 卡类型，如 D/C
bank_card_no_masked string 否 脱敏卡号，格式如 ****5661（卡号后四位）
agreement_no string 否 协议绑定号

响应示例：

{
  "trade_no": "4001010120250525120000000001",
  "bind_status": "SUCCESS",
  "contract_no": "C20250525000001",
  "bank_card_list": [
    {
      "bank_code": "ICBC",
      "bank_card_type": "D",
      "bank_card_no_masked": "****5661",
      "agreement_no": "AGR20250525000001"
    }
  ]
}

响应字段（分支 B：处理中 ）

HTTP 非 200（网关 code=USER_PAYING）。

网关应答示例：

{
  "code": "USER_PAYING",
  "message": "绑卡处理中"
}

响应字段（分支 C：失败 ）

HTTP 非 200（如 code=TRADE_ERROR）。返回失败码与失败描述 code、message

网关应答示例（message 优先渠道/业务文案，如「绑卡链接已过期」；code 为 TRADE_ERROR ，以网关映射为准）：

{
  "code": "TRADE_ERROR",
  "message": "绑卡链接已过期"
}

错误与调用方处理

HTTP 网关 code 触发条件 调用方处理 可重试
200 — bind_status=SUCCESS 按成功分支处理；可读 bank_card_list 否
非 200 USER_PAYING bind_status 为 INIT / PROCESSING 继续轮询 是
非 200 TRADE_ERROR 等 bind_status=FAIL（如链接过期、收敛超时、渠道失败） 读 message；换 out_trade_no 重新发起绑卡 视情况
非 200 NOT_FOUND 流水不存在或 merchant_id 与单号不匹配 核查 out_trade_no / trade_no 否
非 200 INVALID_PARAMETER 未传查询键；out_trade_no 与 trade_no 均未传 至少传一个查询键 是
非 200 SYSTEM_ERROR 系统异常 稍后重试 是