> ## Documentation Index
> Fetch the complete documentation index at: https://docs.waffo.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 订阅订单端点

> 创建和管理订阅订单

订阅订单端点允许您创建周期性计费订单并管理其生命周期。订阅通过收银台会话（`productType: "subscription"`）创建，并通过取消和状态转换进行管理。

## 订阅状态值

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

## 端点

<CardGroup cols={2}>
  <Card title="取消订阅" icon="ban" href="/api-reference/endpoints/subscriptions/cancel-subscription">
    取消活跃或待处理的订阅。
  </Card>
</CardGroup>

## 即将推出

以下端点已规划但尚未实现（当前返回 `501 Not Implemented`）：

* **变更产品**（`POST /v1/actions/subscription-order/change-product`）-- 将订阅升级或降级到其他产品。
* **重新激活订阅**（`POST /v1/actions/subscription-order/reactivate-order`）-- 重新激活已取消的订阅。
