Subscription and Billing

Manage your Alphio subscription, view invoices, change plans, and access the Stripe billing portal.

Find it at: /account/subscribe (plan management) and /account/billing (invoices and payment history).

---

1. Tier matrix intro

Alphio has 4 tiers — Free, Base, Pro, Elite — each unlocking a defined feature set, Credits grant, and Signals access.

See the full per-tier entitlement matrix at /reference/subscription-tiers.

---

2. Upgrading and downgrading

Plan changes use a two-step preview → confirm flow so you can see the proration impact before committing.

1. Open /account/subscribe and pick the target plan and billing interval.
2. Alphio calls previewPlanChange and shows:
   • Immediate charge (or credit) due now from proration
   • Next billing amount after the change takes effect
   • Effective time — upgrades take effect immediately; downgrades take effect at the end of the current cycle
3. Confirm. Alphio then calls changeSubscriptionPlan to apply the change.

Upgrades unlock the new tier's entitlements right away. Downgrades keep your current entitlements until the cycle ends, then drop you to the lower tier.

---

3. Cancel, pause, and resume

• Cancel — /account/subscribe → "Cancel subscription". Subscription continues until the end of the current paid period (cancel_at_period_end), then auto-downgrades to Free.
• Reactivate — Before the period ends, you can undo a cancellation with "Reactivate" — auto-renewal resumes on the same plan. Stripe-only; MoonPay cancellations are irreversible and require a fresh subscribe.
• Pause — Temporarily suspend billing and entitlements. Resume later from the same page.
• Resume — Restart a paused subscription. Billing picks up on the next cycle.

---

4. Payment methods

Alphio supports 5 payment service providers (PSPs), each with its own regional footprint and feature set.

PSP	Typical use	Notes
Stripe	Card payments (most regions)	Full feature support including Billing Portal, reactivate, custom Credits top-up
Paddle	Card / regional alternates (where Stripe isn't preferred)	Subscription only
Apple IAP	iOS in-app purchase	Managed by Apple; cancel via iOS Settings → Subscriptions
Google IAP	Android in-app purchase	Managed by Google Play; cancel via Play Store → Subscriptions
MoonPay	Crypto payment	Cancellation is irreversible — you cannot reactivate, only resubscribe

warning

Exact regional availability per PSP is being finalized. The Subscribe page shows only the PSPs available for your region — that list is authoritative.

---

5. Stripe Billing Portal

For advanced operations Alphio doesn't surface in-app — managing saved cards, viewing the full Stripe-side invoice history, updating tax info — Alphio links out to the Stripe Billing Portal (one-time signed URL).

Open /account/billing and click "Manage payment methods". Alphio generates a portal session bound to your current Stripe subscription and redirects you to Stripe's hosted UI. Changes there sync back automatically.

The portal is Stripe-only. Paddle, IAP, and MoonPay subscriptions are managed through their respective platforms (Paddle dashboard, App Store / Play Store, the MoonPay confirmation email's manage_url).

---

6. Invoices

/account/billing lists every billing event:

• Subscription renewals
• Plan changes and proration adjustments
• Custom Credits top-ups
• Refunds

Each row exposes a Download PDF action that calls Alphio's invoice download endpoint and serves the file directly.

---

7. Custom Credits

Buy Credits à la carte outside the subscription cycle on the Top-Up Credits page at /top-up-credits. Custom Credits land as Recharge Credits and roll over indefinitely (see /reference/credits-system for deduction order).

A dedicated Custom Credits deep-dive page lives in Phase 2 — for now use /top-up-credits directly in-app.

warning

Custom Credits are restricted to Base / Pro / Elite subscribers. Free users will see a paywall pointing back to /account/subscribe.