跳转到主要内容
订阅订单端点允许您创建周期性计费订单并管理其生命周期。订阅通过结账会话(productType: "subscription")创建,并通过取消和状态转换进行管理。

订阅状态值

状态说明
pending订阅已创建,等待首次支付
active活跃状态,正常计费中
trialing免费试用期中
canceling取消请求已提交,当前周期结束前仍活跃
past_due支付失败,重试中
canceled订阅已终止,不再计费
expired订阅已过期

端点

创建订阅订单

使用结账会话创建订阅订单。

取消订阅

取消活跃或待处理的订阅。

即将推出

以下端点已规划但尚未实现(当前返回 501 Not Implemented):
  • 变更产品POST /v1/actions/subscription-order/change-product)— 将订阅升级或降级到其他产品。
  • 重新激活订阅POST /v1/actions/subscription-order/reactivate-order)— 重新激活已取消的订阅。