Account handoff

Manage Subscription

Subscription management will route users into the secure billing portal when account linking is available.

Billing flow states

Connected

When account linking is live, this page can open the secure billing portal.

Manage

Update payment method, cancel, view invoices, or switch plan.

Recover

If no subscription is found, route the user to billing support.

Actual payment architecture

Stripe handles money. Prolifica handles license state.

The website return pages are informational and recovery-oriented. The extension remains responsible for starting checkout, polling status, and syncing the local tier.

create-checkoutcustomer-portalget_my_subscription_statuslicenseManager
1

Checkout session

Extension calls `create-checkout` with price and plan ID. Stripe receives the customer and subscription request.

2

Hosted return

Stripe returns to `/prolifica/checkout-success?session_id={CHECKOUT_SESSION_ID}` or `/prolifica/checkout-cancel`.

3

Subscription sync

Supabase Stripe Sync Engine mirrors Stripe subscription data into the database.

4

License refresh

Prolifica polls `get_my_subscription_status()` and syncs the local tier through licenseManager.

Manage options

  • Update payment method
  • Cancel subscription
  • View invoices
  • Switch plan when plan switching is live

Current beta state

The hosted page is ready for the billing portal handoff. Live portal session creation still belongs to the Prolifica payment flow.