Billing
Billing is managed at the workspace level — one subscription and payment method covers all the projects in that workspace.
Managing your subscription
Open Plans & usage from the workspace menu or from workspace settings. Its Plans & top-ups tab holds everything on this page; the Usage tab shows what consumed your credits.
- Subscription — on a paid plan, one row shows the plan, its monthly credits (N credits/mo), the seat count on per-seat plans, the status, and either Renews or Cancels with a date. Its Manage button opens Stripe's billing portal, where you update the card and find your subscription invoices.
- Change your plan — one card each for Free, Pro and Business. The paid cards have a dropdown for the credit amount (N monthly credits). Business also has Seats: at least 5, or your member count if that's higher (the hint then reads Min N (workspace members)), and at most 500. A number outside that range disables the button.
Each card's button says what pressing it will do: Current plan, Upgrade, Downgrade, Switch to annual, Switch to monthly or Update seats. The two switch labels appear only where annual billing is offered — if you don't see a Monthly / Annual toggle above the plan cards, plans are billed monthly.
Only owners and admins can change anything here. Everyone else sees the same page with the controls disabled and the note Only owners and admins can manage billing. Manage appears only for owners and admins, and only while a subscription is active.
Buying extra credits and setting up auto-reload happen on the same tab, in the Credit balance section — see Plans & credits.
Changing plan
From Free to a paid plan, Upgrade on the Pro or Business card takes you straight to Stripe Checkout, which takes the card and is the confirmation step. Business is bought with the seat count you set on the card. When you come back, the page shows Payment received — updating your balances… while it picks up the new plan.
Any change to an existing subscription — another credit amount, another tier, more or fewer seats, or the other term — opens a confirmation first, titled Change to Pro (or Switch to Business annual for an annual plan). It shows Checking what this costs… while it asks Stripe for a quote, then From, To and, on per-seat plans, Seats. What happens next depends on the direction of the change:
- Charged today — upgrades, adding seats, and switching to annual. The dialog reads $X USD to your card on file, right now, followed by what you'll pay from then on ($Y per month or per year), and the button reads Pay $X now. The prorated difference is charged the moment you press it, and the change takes effect immediately. If the card is declined, the change still goes through and the payment becomes overdue — see If a payment fails. When the change lands on an annual plan, the dialog adds: Annual is a 12-month term — switching back to monthly takes effect at the end of it.
- Nothing is charged today — downgrades, removing seats, and switching back to monthly. You keep what you've paid for until the end of the current period, when the change takes effect. The button reads Schedule the change, and you can undo it any time before then.
Within one term, a change is an upgrade if the new configuration costs the same or more per month, and a downgrade if it costs less. A change of term is decided by the term alone: switching to annual counts as an upgrade even though its per-month rate is lower.
The confirm button stays disabled until Stripe's quote arrives. If the quote can't be fetched, the dialog shows the error and can't be confirmed — cancel and try again. If Stripe can't give an exact figure, the dialog says the prorated difference will be charged and the button reads Confirm and pay now.
When an upgrade raises your monthly credits, the extra credits are added to the current cycle straight away — you don't wait for the next renewal. Adding seats or switching to annual doesn't change the allotment.
A scheduled change shows above the Subscription row. It reads, for example, Scheduled change: switches to Pro (100 credits) on followed by the date, with the seat count added on per-seat plans. Owners and admins can press Keep current plan to cancel it. Making another plan change replaces it.
Owners and admins are emailed either way: Plan changed when a change applies now, Plan change scheduled when it waits for the end of the period. Adding seats without changing plan or term sends no email; the charge appears with your invoices in Stripe's portal.
Cancelling
To cancel, press Downgrade on the Free card. That opens Stripe's cancellation page, where you confirm it.
Cancelling doesn't end the plan straight away. The workspace keeps the plan, its features and the credits already granted until the end of the paid period. Meanwhile the Subscription row reads Cancels with that date, and the Free card's button reads Cancels at period end. Making any plan change under Change your plan before that date withdraws the cancellation. The card for the plan you're on reads Current plan and can't be pressed, so to keep the same plan, open Manage and renew the subscription in Stripe's billing portal before that date.
When the period ends, the workspace returns to Free:
- Unused top-up credit stays on the workspace.
- Paid features stop: custom domains are paused (not deleted), scheduled jobs stop running, purchased seats end, single sign-on settings are locked until you upgrade (your team can still sign in with SSO), and the "Edit with BerryBell" badge returns on published apps.
- The monthly allotment ends, and auto-reload stops charging. The workspace gets the free allowance only if it's the workspace the allowance lands on for its owner — it lands on one workspace per person.
Owners and admins get a cancellation scheduled email when you cancel, and a subscription ended — now on Free email when it ends.
If a payment fails
This covers a failed renewal, and also a declined charge for an upgrade, added seats or a switch to annual — in that case the change still goes through and the payment is overdue. Owners and admins get a payment failed email with the date Stripe will retry. When no retries remain, the email says so: unless the card is updated, the subscription ends and the workspace returns to Free.
While the payment is overdue, Berrybell treats the workspace as Free, so paid features such as custom domains pause until it's paid. Plans & usage doesn't show the Subscription row or Manage in that state, so contact support to update the card. The plan cards will offer Upgrade as if the workspace were on Free. Don't use them while a payment is overdue: that starts a second subscription rather than paying the one that's due.
Your subscription vs. your app's payments
These are two separate things — don't confuse them:
- Your Berrybell subscription is what you pay Berrybell to build and host apps. That's this page.
- Stripe payments are what your customers pay you inside an app you built. That money flows through your own Stripe account, not through Berrybell billing.
Invoices and receipts
- Subscription invoices — renewals, upgrades and seat changes — are in
Stripe's billing portal: open it with Manage. Each renewal also emails
owners and admins
<plan> plan renewed — $X, with a View invoice button. Once the subscription has ended, or while a payment is overdue, Manage isn't shown: use View invoice in a renewal email, or contact support for past invoices. - Top-ups and auto-reloads are one-off card payments and aren't invoiced.
Berrybell emails owners and admins a receipt for each instead:
top-up receipt — $Xorauto-recharge $X.
Billing emails
Billing emails go to every owner and admin of the workspace. Each subject starts
with [BerryBell] <workspace>:, followed by:
| Subject | Sent when |
|---|---|
<plan> plan is active | A subscription starts. It confirms the plan, seats and renewal date. |
<plan> plan renewed — $X | A renewal payment goes through. It has a View invoice button. |
payment failed for the <plan> plan | A renewal payment, or the charge for a plan or seat change, fails. It gives Stripe's next retry date, or says no retries are left. |
plan changed to <plan> / plan change to <plan> scheduled | A plan or term change takes effect now, or any change is scheduled for the end of the period. |
<plan> plan cancellation scheduled | Someone cancels. It says when the plan ends. |
subscription ended — now on Free | The subscription has ended and the workspace is on Free. |
seats increased to N | A new member joined and took the workspace past its purchased seats. The prorated cost appears on the next invoice. |
top-up receipt — $X | Someone buys credits. |
auto-recharge $X | Auto-reload charged the saved card. |
auto-recharge payment failed / auto-recharge paused — payment failed | An auto-reload charge failed. The second means auto-reload has paused itself. |
80% of hosting budget used / hosting budget exhausted | The plan's monthly hosting budget is 80% used, then used up. Each is sent once per billing cycle. |
80% of credit balance used / credit balance exhausted | The credit balance is running low, or used up. Only where one credit balance covers both AI and hosting, and only if you haven't set your own low-balance email. It's checked when hosting usage is charged to the workspace, so spending on AI alone doesn't trigger it. Once per billing cycle. |
credit below $X | Available credit fell below the figure you set in Email me before it runs out (low-balance email). It's checked when hosting usage is charged to the workspace, so it can arrive some hours after the drop, and spending on AI alone doesn't trigger it. Sent once each time it drops below. |
hosting paused — budget used up / hosting resumed | The workspace's published apps were paused because the hosting budget ran out, or are serving again. See Usage & costs. |
The emails say auto-recharge where the Studio says auto-reload; they're the same thing.
One email goes to a person rather than to owners and admins: Welcome to BerryBell, sent once, when the first workspace you create receives the welcome credits. It states how much you got.
Treat these as notifications, not the record: while a subscription is active the invoices are in Stripe's portal, and your balances are always current in Plans & usage.
Questions about a charge
If something about a charge looks wrong, open Manage for the itemized subscription invoice, and the Usage tab in Plans & usage for what consumed credits during the cycle. Usage & costs explains what each line means, and Plans & credits how credits are priced.
Two cases worth knowing:
- Credits you just bought aren't there yet. Credits are added only once Stripe confirms the payment. When you come back from Stripe, the page shows Payment received — updating your balances… and checks again for a few seconds. If the balance still hasn't moved, reload the page; if it still hasn't changed, contact support with the date and amount of the payment.
- You finished checkout but the workspace still shows Free. Reopen Plans & usage. Opening it re-checks your subscription with Stripe and activates a plan that was paid for but didn't come through.
Next steps
- Understand what you're paying for: Plans & credits
- See what consumed credits: Usage & costs
- Take payments in your app: Stripe payments