> ## 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.

# Subscription Order Endpoints

> Create and manage subscription orders

Subscription order endpoints allow you to create recurring billing orders and manage their lifecycle. Subscriptions are created through checkout sessions (with `productType: "subscription"`) and managed via cancellation and status transitions.

## Subscription Status Values

| Status      | Description                                     |
| ----------- | ----------------------------------------------- |
| `pending`   | Subscription created, awaiting first payment    |
| `active`    | Active and billing normally                     |
| `trialing`  | In free trial period                            |
| `canceling` | Cancellation requested, active until period end |
| `past_due`  | Payment failed, retrying                        |
| `canceled`  | Subscription ended, no further billing          |
| `expired`   | Subscription expired                            |

## Endpoints

<CardGroup cols={2}>
  <Card title="Cancel Subscription" icon="ban" href="/api-reference/endpoints/subscriptions/cancel-subscription">
    Cancel an active or pending subscription.
  </Card>
</CardGroup>

## Coming Soon

The following endpoints are planned but not yet implemented (currently return `501 Not Implemented`):

* **Change Product** (`POST /v1/actions/subscription-order/change-product`) -- Upgrade or downgrade a subscription to a different product.
* **Reactivate Subscription** (`POST /v1/actions/subscription-order/reactivate-order`) -- Reactivate a canceled subscription.