Billing & Subscription
Upgrade your Lumio account to a paid plan, download invoices, redeem coupons, and manage your subscription.
Where To Find It
Two pages handle everything billing-related:
- Account → Subscription (
/account/subscription) — pick a plan, start a checkout, see the plan you are on today, and cancel a paid plan. - Account → Billing (
/account/billing) — download invoices and open the Stripe Customer Portal to change your card or cancel. Only the account owner can open this page; anyone else is redirected back to the dashboard.
Both entries only appear in the sidebar's Account section when the active account is one you own.
If billing is currently switched off, these pages show empty states and every action returns "Billing is not enabled".
Plans At A Glance
Lumio has two plans: Free and Pro.
| Limit | Free | Pro |
|---|---|---|
| Overlays | 1 | 5 |
| Widgets | 3 | 20 |
| Storage | 100 MB | 1 GB |
| Upload size per file | 10 MB | 50 MB |
| Integrations | 2 | 10 |
| Chat history | 7 days | 30 days |
| Accounts you can own | 1 | 3 |
| Sounds | 10 | 50 |
| Sound file size / sound storage | 5 MB / 100 MB | 20 MB / 1 GB |
Prices are listed on the Subscription page. Pro is billed in EUR; both monthly and yearly billing are available (yearly is cheaper per month, and the card shows the saving as a percentage).
The plan card itself lists overlays, storage, integrations and chat retention, followed by the plan's feature list (automations, bot modules, copyright detection, …). Feature availability per plan is shown on every card, so you can compare before you upgrade.
Picking A Plan
- Open Account → Subscription.
- Compare the plan cards. The plan you are currently on is highlighted.
- Pick Monthly or Yearly with the interval toggle.
- Click Upgrade on the plan you want.
- You are redirected to Stripe Checkout — a secure, Stripe-hosted page. Enter your card or other payment method and confirm.
- On success you land back on
/dashboard?billing=success. Your new plan is active within seconds.
If you close the Stripe page without paying, you come back to /dashboard?billing=cancelled and nothing changes.
Starting With Free First
During onboarding you have to create a Free account before you can upgrade to Pro. Paid plan buttons are disabled on the onboarding screen with an "Available after Free setup" hint. Once your Free account exists, open Account → Subscription and upgrade from there — Stripe Checkout links the subscription to the existing account automatically.
Managing Your Subscription
Go to Account → Billing and click Manage in Stripe. This opens the Stripe Customer Portal where you can:
- Update your payment method
- Switch between monthly and yearly billing
- View all past invoices (not just the most recent)
- Download receipts as PDF
- Cancel the subscription
Changes made in the portal (plan switch, cancellation, card update) are sent back to Lumio automatically. There is no need to refresh the app.
Cancelling
Cancelling a subscription is cancel-at-period-end:
- You keep full access to your plan until the end of the period you already paid for.
- At the end of that period, the account automatically downgrades to Free.
- Any data that exceeds Free-tier limits (extra overlays, extra storage, chat history older than 7 days) stays in the database but becomes read-only or is trimmed according to the feature — delete items you don't want before the period ends.
You can also cancel directly from the Lumio UI without opening the Stripe portal: the Subscription page shows a Cancel action at the bottom while you are on a paid plan, with a confirmation dialog. Either path sets the same flag on Stripe's side.
Re-subscribing
If you cancelled and are now back on Free, just go through Subscription → Upgrade again. Your existing Stripe customer is reused, so your payment method is remembered.
Invoices
The Billing page lists your 20 most recent invoices with date, amount, status, and a PDF download link. For the full history, open the Stripe Customer Portal.
Invoices are generated by Stripe on every successful payment (and on failed ones with status open). Lumio does not issue its own invoices — the Stripe invoice is the legal document.
Coupons
Coupons are created by Lumio staff for custom deals, beta rewards and partner offers. The Subscription page has no coupon field — a coupon reaches your checkout because Lumio applies it to the checkout session that is created for you, so you see the discounted price on the Stripe Checkout page itself.
A coupon is valid if all of these are true: it exists in Stripe, it is marked active, it has not expired, and it has redemptions remaining. If a coupon you were given does not show up as a discount on the Stripe page, contact whoever issued it.
What Happens When A Payment Fails
- Stripe automatically retries the payment a few times over the following days.
- You receive email from Stripe each time a payment fails.
- The subscription stays active during the retry window — you are not immediately downgraded.
- If all retries fail, Stripe cancels the subscription. Lumio then downgrades the account to Free on the next webhook.
Update your card in the Stripe Customer Portal as soon as possible to avoid interruption.
Permissions
Two account permissions cover billing:
| Permission | What it lets you do |
|---|---|
plan:read | See the current plan and its limits |
plan:edit | Change the plan / manage the subscription |
Only the Owner role holds these by default — Administrator, Moderator and Viewer do not. The plan list itself is not permission-gated, so anyone can open the Subscription page and compare plans, but the Subscription and Billing sidebar entries only appear for the account owner.
The Billing page (invoices + Stripe portal) is owner-only: opening /account/billing as a non-owner redirects you back to the dashboard. Financial data is restricted to the account owner.
Troubleshooting
"Billing is not enabled" Billing is temporarily switched off. Contact Lumio support.
"Stripe price ID not configured for this plan" That plan has no price configured for the interval you picked. Try the other interval, and let Lumio support know.
"No Stripe customer found for this account" The account has never had a paid subscription, so there is no Stripe customer yet. Go through the Subscription page and complete a checkout — the customer is created at that point.
"No active subscription to cancel" The account is already on Free or the subscription was already cancelled on Stripe's side. Nothing to do.
Checkout redirected me back but my plan didn't change The plan change happens when Stripe posts a webhook to Lumio, not when the browser redirects. It normally takes 2–5 seconds. Refresh the Subscription page — if the plan still shows Free after a minute, the webhook may have failed. Contact support and include your checkout session ID from the URL.
My coupon did not show up on the Stripe page The coupon may have expired, been deactivated, or reached its redemption limit. Contact whoever issued it.
I can't see the Billing page even though I'm a member The Billing page is owner-only — opening the URL directly sends you back to the dashboard. Ask the account owner to download invoices for you, or ask them to transfer ownership if you are taking over billing.