基本定义

  • 方法：POST
  • 路径：/v1/wallet/account/opened
  • Content-Type：application/json
  • Auth：统一网关
  • Timeout：5000ms（建议）
  • 描述：查询用户是否已开户

请求字段

字段 类型 必填 约束 说明
identity_document_type string 是 最长 16 证件类型
identity_document_no string 是 最长 64 证件号

请求示例：

{
  "identity_document_type": "ID_CARD",
  "identity_document_no": "310101199001011234"
}

响应字段（分支 A：未开户 account_opened=false）

字段 类型 必填 说明
account_opened boolean 是 固定 false

响应示例：

{
  "account_opened": false
}

响应字段（分支 B：已开户 account_opened=true）

字段 类型 必填 说明
account_opened boolean 是 固定 true
customer_no string 是 客户号
contract_no string 是 签约号
create_time string 是 开户时间，ISO 8601

响应示例：

{
  "account_opened": true,
  "customer_no": "CUS202605180001",
  "contract_no": "WA2026051800001",
  "create_time": "2026-05-18T09:00:00+08:00"
}

错误与调用方处理

HTTP 网关 code 触发条件 调用方处理 可重试
200 — 查询成功（含 account_opened=false 未开户） 未开户走 HTTP-001；已开户保存 contract_no 否
非 200 INVALID_PARAMETER 证件类型/证件号校验失败；Header 缺失 修正参数 是
非 200 UPSTREAM_TIMEOUT 账户侧查询异常 稍后重试 是
非 200 SYSTEM_ERROR 系统异常 稍后重试 是