> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.paymentkit.com/guides/billing/subscriptions/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.paymentkit.com/_mcp/server.

# Subscriptions

## Docs

- [Subscription lifecycle](https://docs.paymentkit.com/guides/billing/subscriptions/subscription-lifecycle.md): Understand how subscriptions move through states from creation to cancellation, and how payment outcomes drive automatic transitions.
- [Create a subscription](https://docs.paymentkit.com/guides/billing/subscriptions/create-a-subscription.md): Start billing a customer on a recurring schedule by creating a subscription with one or more prices.
- [Update a subscription](https://docs.paymentkit.com/guides/billing/subscriptions/update-a-subscription.md): Update subscription-level settings, manage items (add/remove/modify), adjust quantities and prices, with control over proration timing and behavior for mid-cycle changes.
- [Change subscription plan](https://docs.paymentkit.com/guides/billing/subscriptions/change-subscription-plan.md): Move items to different billing intervals or contract terms with automatic subscription splitting, proration handling, and support for immediate or scheduled execution.
- [Subscription change requests](https://docs.paymentkit.com/guides/billing/subscriptions/subscription-change-requests.md): Multi-step workflow for previewing and applying subscription changes with explicit payment control, conflict resolution, and idempotent retry support.
- [Plan change events](https://docs.paymentkit.com/guides/billing/subscriptions/plan-change-events.md): Which webhook events fire for every kind of subscription plan change — upgrades, downgrades, and changes during a trial — what each payload carries, and why you should never detect a plan change from invoice.paid.
- [Pause a subscription](https://docs.paymentkit.com/guides/billing/subscriptions/pause-a-subscription.md): Temporarily suspend billing on a subscription without cancelling it. Configure when to pause and when to automatically resume.
- [Cancel a subscription](https://docs.paymentkit.com/guides/billing/subscriptions/cancel-a-subscription.md): End a subscription immediately, at period end, or on a scheduled date. Choose a refund strategy that fits your use case.