绑卡列表H5查询

基本定义

方法：POST
网关路径：/v1/wallet/h5/agreements
Content-Type：application/json
Auth：统一网关
Timeout：5000ms（建议）
幂等键：merchant_id + out_trade_no
描述：申请绑卡列表展示 H5 页面链接；返回完整 url，交给用户直接打开

请求字段

字段	类型	必填	约束	说明
`out_trade_no`	string	是	最长 64	商户订单号
`contract_no`	string	是	最长 32	签约号
`page_url`	string	否	最长 256；URL	用户离开 H5 页后的回跳地址
`notify_url`	string	否	最长 256；URL	通知地址

请求示例：

{
  "out_trade_no": "MCH202505250011",
  "contract_no": "C20250525000001",
  "page_url": "https://merchant.example.com/h5/agreements/return",
  "notify_url": "https://merchant.example.com/callback/wallet/bind"
}

响应字段（成功）

HTTP 200。

字段	类型	必填	约束	说明
`out_trade_no`	string	是	与请求一致	商户订单号
`url`	string	是	URL	绑卡列表 H5 完整入口链接
`expire_time`	string	是	ISO 8601	链接过期时间

响应示例：

{
  "out_trade_no": "MCH202505250011",
  "url": "https://cutpayment.example.com/h5/agreements/index.html?token=a1b2c3d4e5f6789012345678abcdef11",
  "expire_time": "2026-05-25T15:30:00+08:00"
}

错误与调用方处理

HTTP	网关 `code`	触发条件	调用方处理	可重试
`200`	—	链接申请成功	将 `url` 交给用户打开 H5 页	否
非 `200`	`INVALID_PARAMETER`	参数缺失或格式错误；Header 缺失	修正参数	是
非 `200`	`TRADE_ERROR`	产品未开通、H5 链接申请失败、`contract_no` 无效	核查签约号或换 `out_trade_no`	视情况
非 `200`	`ORDER_DUPLICATED`	幂等命中已有流水	换 `out_trade_no` 或回放历史链接	否
非 `200`	`NOT_FOUND`	签约号在账户侧不存在	核查 `contract_no`	否
非 `200`	`SYSTEM_ERROR`	系统异常	稍后重试	是