查询支付订单

接口说明

  • 适用场景：【扣款查询】根据扣款单号查询扣款单详情
  • 方法：POST
  • 路径：/v1/subscription/deduction/query

请求字段

字段 类型 必填 约束 匹配后（key / 中文名） 说明
trade_no string 是 最长 64 trade_no / 平台交易号 扣款单号

响应字段

字段 类型 必填 匹配后（key / 中文名） 说明
trade_no string 是 trade_no / 平台交易号 扣款单号
subscription_no string 是 subscription_no / 订阅号 订阅号
original_amount integer 是 original_amount / 原始应扣金额 原始应扣金额（分）
actual_amount integer 是 actual_amount / 实际扣款金额 实际扣款金额（分）
deduct_period integer 是 deduct_period / 扣款周期数 扣款期数
trade_status string 是 trade_status / 交易状态 交易状态
retry_count integer 是 retry_count / 已重试次数 已重试次数
channel_order_no string 否 channel_order_no / 渠道订单号 渠道订单号
error_code string 否 error_code / 业务错误码 错误码；成功时为空
error_message string 否 error_message / 业务错误信息 错误描述；成功时为空
deduction_time string 否 deduction_time / 扣款完成时间 扣款完成时间
create_time string 是 create_time / 创建时间 创建时间

请求示例：

{
  "trade_no": "DD01010120260319120000000001"
}

响应示例（成功）：

{
  "trade_no": "DD01010120260319120000000001",
  "subscription_no": "SP01010120260319120000000001",
  "original_amount": 1990,
  "actual_amount": 1592,
  "deduct_period": 3,
  "trade_status": "SUCCESS",
  "retry_count": 0,
  "channel_order_no": "CH2026031912000001",
  "deduction_time": "2026-05-25T16:00:00+08:00",
  "create_time": "2026-05-25T16:00:00+08:00"
}

响应示例（失败）：

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

错误与调用方处理

HTTP code 触发条件 调用方处理
200 — 查询成功 按 trade_status 判定终态
非 200 ORDER_NOT_FOUND 扣款单不存在 核查 trade_no
非 200 MERCHANT_NOT_FOUND Header 主体与单据不匹配 核查主体
非 200 INVALID_PARAMETER 参数错误 修正参数后重试

##