绑卡协议列表

建议超时 5000ms。按 contract_no 查询当前有效的绑卡协议列表。空列表不是错误。

接口说明

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

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

请求参数

Header 参数

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

Body 参数

参数名 类型 必填 描述
contract_no string true 签约号；最长 32

请求示例

{
  "contract_no": "CONTRACT001"
}

应答参数

200 OK

参数名 类型 必填 描述
contract_no string true 签约号
card_agreement_list array true 协议列表（按 bind_order 升序）；无卡时为 []
card_agreement_list[].agreement_no string true 协议绑定号
card_agreement_list[].bind_order integer true 扣款顺序（升序尝试）
card_agreement_list[].bank_code string false 银行编码
card_agreement_list[].bank_card_type string false 卡类型，如 D/C
card_agreement_list[].bank_card_no_masked string false 脱敏卡号，如 ****5661

应答示例

200 OK

{
  "contract_no": "CONTRACT001",
  "card_agreement_list": [
    {
      "agreement_no": "AGREEMENT001",
      "bind_order": 1,
      "bank_code": "ICBC",
      "bank_card_type": "D",
      "bank_card_no_masked": "****5661"
    }
  ]
}

错误码

公共错误码

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

业务错误码

状态码 错误码 描述 解决方案
非 200 INVALID_PARAMETER 参数错误 修正参数
非 200 UPSTREAM_TIMEOUT 查询异常 稍后重试

应答示例

失败

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

应答示例

失败

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

应答示例

失败

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