查询订阅订单POST /v1/subscription/query

Header：Baofu-Mch-ID 必填。

Body 字段说明

字段 类型 必填 最大长度 说明
subscriptionNo string 与 outTradeNo 二选一 32 订阅号（内部订单号）
outTradeNo string 与 subscriptionNo 二选一 64 商户订单号（外部订单号）

约束：subscriptionNo 与 outTradeNo 须恰好其一非空（trim 后），同时为空或同时非空均报错。

请求示例（按订阅号查询）

{
  "subscriptionNo": "SP01010120260319120000000001"
}

请求示例（按商户订单号查询）

{
  "outTradeNo": "MCH202603190001"
}

响应 data 字段说明

成功时 data 为订阅视图对象，字段与签约成功响应一致：

字段 类型 说明
subscriptionNo string 订阅号
merchantNo string 商户号（可空）
outTradeNo string 商户签约订单号
productCode string 内部产品编码
userId string 用户标识
cycleType string 周期类型，见 §3.3
cycleValue number 周期值
fixedDay number 固定扣款日（依周期模型）
baseAmount number 每期扣款基准金额（分），对应库表 base_amount；由产品配置、营销算价或变更接口 specifiedAmount 决定
appliedPricingType string 应用的定价类型枚举码，见 §3.6（如 MERCHANT_SPECIFIED 表示商户经变更接口指定金额、不经营销算价）
status string 订阅状态，见 §3.1
signTime string 签约时间
cancelTime string 取消时间（未取消时为 null）
nextDeductionTime string 下次计划扣款时间
currentPeriod number 当前期数
totalPeriod number 总期数；null 为永续

成功响应示例

{
  "success": true,
  "code": null,
  "message": null,
  "data": {
    "subscriptionNo": "SP01010120260319120000000001",
    "merchantNo": "M100001",
    "outTradeNo": "MCH202603190001",
    "productCode": "PC202603260001",
    "userId": "U10001",
    "cycleType": "MONTH",
    "cycleValue": 1,
    "fixedDay": null,
    "baseAmount": 1990,
    "appliedPricingType": "FIRST_PERIOD_DISCOUNT",
    "status": "ACTIVE",
    "signTime": "2026-03-19 12:00:00",
    "cancelTime": null,
    "nextDeductionTime": "2026-04-19 12:00:00",
    "currentPeriod": 1,
    "totalPeriod": 12
  }
}

###