Billing
Explain plan access, subscription status, and billing actions clearly
Subscriptions are built around Stripe checkout, the billing portal, tier changes, and status checks. The billing docs should tell users what they get and how to manage it.
01Section
Plan tiers
The app supports free and paid tiers, and the backend normalizes the subscription tier before using it for access control. Core journal, account, review, calendar, news, collaboration, and scoped API features stay free. Paid tiers add the AI layer — tutor chat, generated insights, and live voice. Separately labeled previews can require account eligibility while they are tested.
02Section
Stripe portal
Users can create checkout and portal sessions from the app so they can upgrade, cancel, or manage their plan without support intervention.
03Section
Status
The app checks subscription status from settings and throughout the product to decide whether premium-only features should be available.
04Section
Coupons
Promo codes and coupons are managed by the admin side and can be applied during checkout.
Billing story
A practical example for this feature.
A user upgrades on the subscription page, then the app reads the active tier and unlocks premium features everywhere else.