支付订单查询

按商户订单号查询协议支付订单状态。须区分：查询异常（订单不存在等）返回 success=false 且 code 如 ORDER_NOT_FOUND；查到订单且终态失败时 success=true 且 trade_status=FAILED。

接口说明

请求方式：【POST】/v1/protocol/order-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	true	商户订单号，6～64 字符

请求示例

{
  "out_trade_no": "20260609120001001"
}

应答参数

200 OK

参数名	类型	必填	描述
trade_status	string	true	交易状态，见 trade_status 枚举
trade_status_desc	string	false	状态说明
out_trade_no	string	false	商户订单号
channel_order_no	string	false	宝付订单号
payment_total_amount	integer	false	成功金额，单位分
successful_payment_time	string	false	成功支付时间（成功时），ISO 8601

应答示例

200 OK

{
  "trade_status": "SUCCESS",
  "trade_status_desc": "交易成功",
  "out_trade_no": "20260609120001001",
  "channel_order_no": "20260609120001001",
  "payment_total_amount": 100,
  "successful_payment_time": "2026-06-09T12:00:15+08:00"
}

应答示例

200 OK

{
  "trade_status": "FAILED",
  "trade_status_desc": "交易失败",
  "out_trade_no": "20260609120001001",
  "channel_order_no": "20260609120001001",
  "payment_total_amount": 100
}

错误码

公共错误码

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

应答示例

失败

{
  "code": "ORDER_NOT_FOUND",
  "message": "订单不存在"
}