扣款结果查询

建议超时 5000ms。查询键：out_trade_no 或 trade_no（至少传一个）。仅在单不存在时返回错误；FAIL/PROCESSING 均为 HTTP 200 + trade_status。

接口说明

请求方式：【POST】/v1/wallet/deduct/query

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

请求参数

Header 参数

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

Body 参数

参数名 类型 必填 描述
out_trade_no string false 商户订单号；与 trade_no 二选一
trade_no string false 平台交易号；与 out_trade_no 二选一

请求示例

{
  "out_trade_no": "DED202505250001"
}

应答参数

200 OK

参数名 类型 必填 描述
trade_no string true 平台交易号
out_trade_no string true 商户订单号
trade_status string true SUCCESS；或 FAIL / PROCESSING
success_agreement_no string true 成功协议绑定号（成功时）
payment_amount integer true 扣款金额（分）（成功时）
successful_payment_time string true 成功时间（成功时）
bank_code string false 银行编码（成功时）
bank_card_type string false 卡类型（成功时）
bank_card_no_masked string false 脱敏卡号（成功时）

应答示例

200 OK

{
  "trade_no": "4101010120250525120000000001",
  "out_trade_no": "DED202505250001",
  "trade_status": "SUCCESS",
  "success_agreement_no": "AGR20250525000001",
  "payment_amount": 1990,
  "successful_payment_time": "2026-05-25T15:10:01+08:00",
  "bank_code": "ICBC",
  "bank_card_type": "D",
  "bank_card_no_masked": "****5661"
}

应答示例

200 OK

{
  "trade_no": "4101010120250525120000000001",
  "out_trade_no": "DED202505250001",
  "trade_status": "PROCESSING"
}

错误码

公共错误码

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

业务错误码

状态码 错误码 描述 解决方案
非 200 NOT_FOUND 订单不存在 核查单号与商户号
非 200 INVALID_PARAMETER 查询键均未传 至少传一个

应答示例

失败

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

应答示例

失败

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

应答示例

失败

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