基本定义
- 方法：
POST - 路径：
/v1/wallet/account/unbind - Content-Type：
application/json - Auth：统一网关
- Timeout：
5000ms（建议） - 描述：解绑指定签约协议
请求字段
| 字段 | 类型 | 必填 | 约束 | 说明 |
|---|---|---|---|---|
out_trade_no |
string | 是 | 最长 64 | 商户解绑订单号；幂等键：merchant_id + out_trade_no |
contract_no |
string | 是 | 最长 32 | 签约号 |
agreement_no |
string | 是 | 最长 64 | 协议绑定号（来自 HTTP-005） |
reason |
string | 是 | 最长 80 | 解绑原因（原 endReason；网关字段 reason） |
请求示例：
{
"out_trade_no": "UNBIND202505250001",
"contract_no": "CONTRACT001",
"agreement_no": "AGREEMENT001",
"reason": "用户主动解绑"
}响应字段（成功）
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
unbind_status |
string | 是 | 固定 SUCCESS |
响应示例：
{
"unbind_status": "SUCCESS"
}响应字段（失败）
HTTP 非 200（如 UNBIND_FAILED） 字段；错误信息 code/message。
错误与调用方处理
| HTTP | 网关 code |
触发条件 | 调用方处理 | 可重试 |
|---|---|---|---|---|
200 |
— | 解绑成功；或幂等重放（同 out_trade_no 且 contract_no/agreement_no 一致） |
刷新 HTTP-005 协议列表 | 否 |
非 200 |
TRADE_ERROR |
解绑失败 | 核查协议是否已解绑或状态异常 | 视情况 |
非 200 |
ORDER_DUPLICATED |
同 out_trade_no 已存在但 contract_no 或 agreement_no 与历史不一致 |
换 out_trade_no 或核对参数 |
否 |
非 200 |
INVALID_PARAMETER |
参数校验失败；Header 缺失 | 修正参数 | 是 |
非 200 |
SYSTEM_ERROR |
系统异常 | 稍后重试 | 是 |
