跳转到主要内容
恢复当前处于 canceling 状态的订阅。预约在周期末的取消会被撤销，订阅按原计划继续续费。 
POST /v1/actions/subscription-order/reactivate-order
认证方式： Session Token — 见 Customer Endpoints（customer 或 buyer 角色）

​
恢复行为

当前状态操作结果状态
canceling撤销周期末取消（通过 PSP）active
canceled不允许 — 已完全取消—
pending / active / past_due / expired不允许 — 仅 canceling 可恢复—
  • 仅 canceling（已预约周期末取消）状态的订阅可恢复。
  • 已完全取消（canceled）的订阅无法恢复 — 请创建新订阅。
  • 无额外费用 — 当前计费周期继续，并按原计划恢复续费。

​
请求体

字段类型必需说明
orderIdstring是订阅订单 ID（Short ID 格式 ORD_xxx）

​
请求示例

import { WaffoPancake } from "@waffo/pancake-ts";

const client = new WaffoPancake({
  sessionToken: window.WAFFO_SESSION_TOKEN, // 由商户门户注入
  environment: "prod",
});

const result = await client.orders.reactivateSubscription({
  orderId: "ORD_2aUyqjCzEIiEcYMKj7TZtw",
});

console.log(result.orderId); // "ORD_2aUyqjCzEIiEcYMKj7TZtw"
console.log(result.status);  // "active"

​
成功响应 (200)

{
  "data": {
    "orderId": "ORD_2aUyqjCzEIiEcYMKj7TZtw",
    "status": "active"
  }
}

​
响应字段

字段类型说明
orderIdstring订单 ID（Short ID）
statusstring新的订单状态（active）

​
错误响应

重试策略：4xx 一律不要重试 — 修正请求后重发。5xx 指数退避重试（起步 5s，最多 3 次）。
状态码errors[0].message含义推荐处理
400Missing required field: orderId请求体未提供 orderId修正请求体后重新提交
400Expected format: ORD_xxx, got "..."orderId Short ID 解码失败修正 orderId 格式后重新提交
400Only canceling subscriptions can be reactivated订单状态非 canceling（如 canceled、active、expired）该订阅不可恢复
401Authentication failedSession token 无效、过期或格式错误通过 Issue Session Token 重新签发
403Order does not belong to user归属校验失败验证调用方拥有该订单
404Order not found订单不存在验证 order ID
500Internal server error服务端意外失败指数退避重试（起步 5s，最多 3 次）