NATSpayment.subscription.extend延长订阅

以自然日顺延下次续订时间。

Request Payload

消息格式:JSON

NameData TypeRequiredDescription
subscriptionIdstringYes订阅 ID
daysnumberYes延长天数(1-365)
operatorIdstringYes操作管理员 ID(审计用)
reasonstringYes延长原因(审计用)
type RequestBody = {
  /** 订阅 ID */
  subscriptionId: string
  /** 延长天数(1-365) */
  days: number
  /** 操作管理员 ID(审计用) */
  operatorId: string
  /** 延长原因(审计用) */
  reason: string
}
{
  "subscriptionId": "01JD8SOBHV0C3D9JD",
  "days": 14,
  "operatorId": "01JD8SEGQ0P9N2XK4L7VDH3T6C",
  "reason": "服务故障补偿"
}

Response Payload

回复使用统一信封 {id, code, messages, result},其 result:

NameData TypeRequiredDescription
subscriptionIdstringYes订阅 ID
statusstringYes订阅状态
nextRenewalAtstringYes顺延后的下次续订时间
type ResponseBody = {
  /** 订阅 ID */
  subscriptionId: string
  /** 订阅状态 */
  status: string
  /** 顺延后的下次续订时间 */
  nextRenewalAt: string
}
{
  "subscriptionId": "01JD8SOBHV0C3D9JD",
  "status": "active",
  "nextRenewalAt": "2026-11-27T09:00:00Z"
}

Response Code

回复使用统一信封 {id, code, messages, result},其 code 字段:

code Meaning Notes
0 成功 延长订阅
2805 订阅已过期不允许延长

Examples

{ "subscriptionId": "01JD8SOBHV0C3D9JD", "days": 14, "operatorId": "01JD8SEGQ0P9N2XK4L7VDH3T6C", "reason": "服务故障补偿" }
{
  "id": "01JD8SX9XM3K0LH",
  "code": 0,
  "messages": [],
  "result": {
    "subscriptionId": "01JD8SOBHV0C3D9JD",
    "status": "active",
    "nextRenewalAt": "2026-11-27T09:00:00Z"
  }
}