# New Billing & subscriptions docs space

Merchants integrating subscription billing with the Merchant API previously had only the API reference to work from — endpoints and schemas, without any guidance on how the pieces fit together. 

The new [Billing & subscriptions](/docs/guides/merchant/billing-subscriptions/introduction) docs space closes that gap. It debuts with conceptual foundations and step-by-step API integration guides for every subscription plan model, so you can go from choosing a plan to keeping subscriptions alive in production without reverse-engineering the specs.

## What's in the space

The space opens with two kinds of content.

### Conceptual foundations

- [:AddProduct: Subscription plans](/docs/guides/merchant/billing-subscriptions/subscription-plans 'Understand plans, variations, phases, and pricing models')
- [:Workflow: Subscription lifecycle](/docs/guides/merchant/billing-subscriptions/subscription-lifecycle 'Learn about subscription states, transitions, and how to handle them')

### API integration guides

- [:DocumentChecked: Introduction to the Subscriptions API](/docs/guides/merchant/billing-subscriptions/api/introduction 'Integration model and choosing your pricing approach')
- [:Rocket: Get started](/docs/guides/merchant/billing-subscriptions/api/get-started 'Create your first plan and subscription, and collect the first payment')
- [:Repayment: Build a fixed-rate subscription](/docs/guides/merchant/billing-subscriptions/api/fixed 'End-to-end guide for flat-rate plans')
- [:PlaneSeat: Build a per-seat subscription](/docs/guides/merchant/billing-subscriptions/api/per-seat 'End-to-end guide for per-seat plans')
- [:LimitHigh: Build a usage-based subscription](/docs/guides/merchant/billing-subscriptions/api/usage-based 'End-to-end guide for metered billing')
- [:Voucher: Build a subscription with trials and introductory pricing](/docs/guides/merchant/billing-subscriptions/api/trials 'End-to-end guide for trials and promotional phases')
- [:Webhook: Track subscriptions with webhooks](/docs/guides/merchant/billing-subscriptions/api/webhooks 'Receive real-time events when subscription states change')

Every integration guide ends with an implementation checklist, so you can confirm a plan model is fully wired before you go live.

The no-code path follows next, so merchants integrating subscriptions through the dashboard without writing code will get the same level of guidance.

## Get started

If you're integrating subscriptions over the API, start with [Get started with the Subscriptions API](/docs/guides/merchant/billing-subscriptions/api/get-started) and pick the guide for your plan model from there.