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:
- Dashboard → Account → Subscription (
/account/subscription) — pick a plan, start a checkout, see the plan you are on today. - Dashboard → 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.
If your deployment has billing disabled (self-hosted Lumio without Stripe), these pages will show empty states and every action returns "Billing is not enabled".
Plans At A Glance
| Plan | Overlays | Storage | Upload size | Integrations | Chat history |
|---|---|---|---|---|---|
| Free | 3 | 100 MB | 5 MB | 2 | 7 days |
| Pro | 25 | 2 GB | 25 MB | Unlimited | 90 days |
| Enterprise | 100 | 10 GB | 100 MB | Unlimited | Unlimited |
Prices are listed on the Subscription page. Pro and Enterprise are billed in EUR; both monthly and yearly billing are available (yearly is cheaper per month).
Each plan also unlocks specific features (automations, bot modules, copyright detection, …). The Subscription page shows the full feature list for every plan next to its price.
Picking A Plan
- Open Dashboard → Account → Subscription.
- Compare the plan cards. The plan you are currently on is highlighted.
- Pick Monthly or Yearly with the interval toggle.
- (Optional) Enter a coupon code in the field above the plans. Valid codes show the discount preview. Invalid codes show an error and are not applied.
- Click Upgrade to {Plan}.
- 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.
Signing Up With A Paid Plan Directly
You don't need an existing account to buy Pro or Enterprise. If you pick a plan before creating an account, Lumio creates the account for you as soon as payment succeeds — the subscription is linked to it automatically and you are made the owner.
Managing Your Subscription
Go to Dashboard → Account → Billing and click Manage in Stripe. This opens the Stripe Customer Portal where you can:
- Update your payment method
- Change plan (Pro ↔ Enterprise, or switch between monthly and yearly)
- 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. 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
Coupon codes can come from two sources:
- Stripe promotion codes — used at checkout. Enter the code in the coupon field on the Subscription page. The discount is validated live and applied to the checkout session.
- Lumio-issued coupons (admin-only) — created by Lumio staff via the admin panel for custom deals, beta rewards, etc. Your account admin redeems these on your behalf.
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. The validation endpoint will tell you the exact reason if it is not valid.
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
To see or manage billing you need these permissions on your account role:
| Permission | What it lets you do |
|---|---|
billing:read | See the billing page and invoices |
billing:edit | Start a checkout, open the Stripe portal, cancel the subscription |
plan:read | See the current plan and its limits |
plan:edit | Change the plan / manage the subscription |
Owner and Administrator roles have all of these by default. Moderator and Viewer roles do not — they can see the subscription page (the plan list is public) but cannot trigger any purchase or cancellation.
The Billing page (invoices + portal) is owner-only in the UI even if your role has billing:read — financial data is restricted to the account owner.
Troubleshooting
"Billing is not enabled" Your Lumio deployment has Stripe turned off. This is expected on self-hosted deployments that don't accept payments. Contact your deployment admin.
"Stripe price ID not configured for this plan"
The plan in the database is missing its stripe_monthly_price_id or stripe_yearly_price_id. An admin needs to fill this in via the admin panel. Try the other interval in the meantime.
"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.
The coupon I entered says "invalid" Check: the code is spelled exactly as given (Stripe codes are case-sensitive), the promotion is still active, the promotion has not reached its redemption limit, and the code is tied to a promotion code (not just a raw coupon id — Lumio only accepts promotion codes in the checkout flow).
I can't see the Billing page even though I'm a member The Billing page is owner-only. Ask the account owner to download invoices for you, or ask them to transfer ownership if you are taking over billing.