解绑银行卡

建议超时 5000ms。幂等键：商户号 + out_trade_no。

接口说明

请求方式：【POST】/v1/wallet/account/unbind

请求域名：【主域名】https://api.baofu.com

请求参数

Header 参数

参数名 类型 必填 描述
Authorization string true 请参考【开发指引-整体说明】生成认证信息
Accept string true 请设置为 application/json
Content-Type string true 请设置为 application/json

Body 参数

参数名 类型 必填 描述
out_trade_no string true 商户解绑订单号；最长 64
contract_no string true 签约号；最长 32
agreement_no string true 协议绑定号（来自协议列表）；最长 64
reason string true 解绑原因；最长 80

请求示例

{
  "out_trade_no": "UNBIND202505250001",
  "contract_no": "CONTRACT001",
  "agreement_no": "AGREEMENT001",
  "reason": "用户主动解绑"
}

应答参数

200 OK

参数名 类型 必填 描述
unbind_status string true 固定 SUCCESS

应答示例

200 OK

{
  "unbind_status": "SUCCESS"
}

错误码

公共错误码

状态码 错误码 描述 解决方案
401 SIGN_ERROR 验证不通过 请参阅【开发指引-整体说明】排查签名
400 PARAM_ERROR 参数错误 请根据错误提示正确传入参数
500 SYSTEM_ERROR 系统异常，请稍后重试 请稍后重试

业务错误码

状态码 错误码 描述 解决方案
非 200 TRADE_ERROR 解绑失败 核查协议状态
非 200 UNBIND_FAILED 解绑失败 核查协议状态
非 200 ORDER_DUPLICATED 同 out_trade_no 已存在但协议参数不一致 换单或核对参数
非 200 INVALID_PARAMETER 参数校验失败 修正参数

应答示例

失败

{
  "code": "TRADE_ERROR",
  "message": "交易失败"
}

应答示例

失败

{
  "code": "UNBIND_FAILED",
  "message": "交易失败"
}

应答示例

失败

{
  "code": "ORDER_DUPLICATED",
  "message": "交易失败"
}

应答示例

失败

{
  "code": "INVALID_PARAMETER",
  "message": "交易失败"
}

应答示例

失败

{
  "code": "SYSTEM_ERROR",
  "message": "交易失败"
}