Billing & Subscription
Upgrade your channel to a paid plan, download invoices, and manage the subscription.
Where To Find It
Open Settings at the bottom of the dashboard sidebar, select the channel you own, then choose an area under Subscription:
- Subscription (
/dashboard/settings/channel/subscription) - see the active channel's plan and billing cadence, compare plans, start checkout, or request cancellation. - Invoices (
/dashboard/settings/channel/billing) - see invoices, download PDFs, and open the Stripe Customer Portal to update payment details.
These areas appear only for the owner of the selected channel. A direct short link opens the settings window over the dashboard home; a non-owner sees No access. Switch to a channel you own before opening either area.
If billing (Stripe) is not set up on this Lumio installation, the Subscription area still shows your current plan with its limits and every plan card, Free included. Only what needs Stripe is switched off: the upgrade buttons, switching to Free and cancelling. A line above the plan cards says "Payments are not set up in this environment." The Invoices area shows the note "Billing is not set up in this environment." instead of invoices. Platform admins additionally see that the Stripe keys (LUMIO__STRIPE__*) are missing.
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 |
| Channel data (chat, events, chatter profiles, moderation) | 365 days (1 year) | 1095 days (3 years) |
| 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 and include VAT. Pro is billed in EUR; both monthly and yearly billing are available (yearly is cheaper per month, and the toggle shows the saving as a percentage).
The plan card itself lists overlays, storage, integrations and how long channel data is kept ("1 year of channel data" on Free, "3 years of channel data" on Pro; a window that is not a whole number of years is shown in days). A muted line under it names what that covers: chat, events, chatter and moderation data. Stream reports do not count against the window: they stay until you dissolve the channel. Stream-history curves have separate detail windows: 60-second samples for 90 days and 5-minute samples for 12 months; older history uses the 1-hour rollup. The list is followed by the plan's feature list (automations, bot modules, Copyright Manager, …). Feature availability per plan is shown on every card, so you can compare before you upgrade.
Picking A Plan
- Open Settings → Channel → Subscription.
- Compare the plan cards. The plan you are currently on is highlighted.
- Pick Monthly or Yearly with the interval toggle.
- Tick the checkbox above the plan cards (see Right of withdrawal below). It starts unticked, and the Switch to … buttons stay disabled until you tick it.
- Click Switch to … 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.
Right Of Withdrawal
As a consumer in the EU you have a 14-day right of withdrawal. Lumio starts your plan as soon as you pay, so before every plan checkout you confirm that in a separate checkbox above the plan cards:
I expressly request that Lumio starts providing the service immediately, before the 14-day withdrawal period ends. I understand that my right of withdrawal lapses once Lumio has fully performed the contract, and that if I withdraw, I pay a pro-rata amount for the service provided up to that point.
The Withdrawal information link next to it opens the withdrawal section of the terms of use in a new window. The checkbox is required: if you press a Switch to … button without ticking it, a message under the box asks you to tick it and no checkout starts. It is shown in your dashboard language (German or English) and never comes pre-ticked. After payment you get an order confirmation by e-mail that repeats the declaration you ticked, with the full withdrawal information and the terms of use.
A renewal of the same subscription needs no new tick; every plan change goes through the checkout again and asks again.
Starting With Free First
A new channel always starts on Free, during onboarding and in the Create New Account wizard (/account/new) alike. Paid plans are shown there but cannot be picked: onboarding shows an "Available after Free setup" hint, the wizard a note that you switch to a paid plan afterwards under Subscription (or, without Stripe, that payments are not set up). Once your Free channel exists, open Settings → Channel → Subscription and upgrade from there - Stripe Checkout links the subscription to the existing channel automatically.
Managing Your Subscription
Go to Settings → Channel → Subscription → Invoices and click Open customer portal (or Payment details at Stripe in the header). The Stripe Customer Portal opens in a new tab, 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
Stripe sends subscription and payment updates back to Lumio. Refresh the page if a recent portal action is not visible yet.
Cancelling
Choose Verträge hier kündigen in Subscription to open the plan cancellation dialog, or use the public /cancel page from the footer. You can request an ordinary cancellation at the end of the paid period or an extraordinary cancellation with a reason and requested time. The dialog lets you check the receipt address and print the confirmation. See Withdrawal & Cancellation for the signed-out flow and paid extension subscriptions.
For an ordinary cancellation accepted by Stripe, you keep plan access until the paid period ends and the account then moves to Free. Older chat, event, chatter and moderation data follow Free-tier retention at the next sweep; review overlays and storage above Free-tier limits. An extraordinary request waits for operator review and does not change the Stripe subscription automatically. Lumio records and confirms the request even if Stripe needs a retry.
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 Invoices area 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.
- Lumio sends the channel owner an in-app and email payment-failure notice; Stripe may also email about the payment.
- 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. The subscription and invoice areas additionally check that you own the active channel.
The Invoices area (invoices + Stripe portal) is owner-only: a non-owner opening /dashboard/settings/channel/billing sees No access. Financial data is restricted to the channel owner.
Troubleshooting
"Billing is not set up in this environment" / "Payments are not set up in this environment"
This Lumio installation has no Stripe connection, so there is nothing to buy or pay. Your plan and Free stay usable. On lumio.vision, contact Lumio support; on your own installation, a platform admin sets the LUMIO__STRIPE__* keys.
"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 cannot open the Invoices area even though I am a member The Invoices area is owner-only. A non-owner opening its short link sees No access. Ask the account owner to download invoices for you, or ask them to transfer ownership if you are taking over billing.