"subscription": null and resolves to
Free. Usage & billing turns the same two fields into one line: Renews Oct 2,
2026, or Cancels Oct 2, 2026 when cancel_at_period_end is true.
Subscribing
checkout_url. Stripe collects the billing address, works
out the tax for their region, and returns them to /account?session_id=…, where
the app re-reads the plan and the balance so the new tier shows immediately.
string
required
pro, max or max_20x. free is not purchasable and is refused.string
required
monthly or yearly. Nothing else.Changing a plan
The same endpoint, called by somebody who already pays, does not create a second subscription — that would charge them twice until one was canceled. It answers 409 with a portal link instead:portal_url is deep-linked into Stripe’s plan picker when you asked for a
different plan or interval, and lands on the generic portal page when you asked
for the one you are already on. The message says which: use portal to change plan, or already on this plan, use portal to change billing interval.
You can also ask for the portal directly — this is what Manage on
Usage & billing does:
A subscription bought in the iOS app goes through the App Store, not Stripe. The
app detects that and sends Manage to Apple’s subscription management page
instead; a Stripe portal cannot cancel an Apple subscription.
Invoices
In the portal. Stripe holds the invoices, the receipts and the card, and the portal is the only place they are shown — Splox stores none of them. The Transactions screen is a different ledger: wallet top-ups and the charges against them, not subscription invoices. See Extra usage.Canceling
Cancel in the portal. Stripe setscancel_at_period_end and tells Splox; you
keep the plan you paid for until current_period_end, and the screen changes
from Renews to Cancels on that date. At the end of the period the account
resolves to Free.
A plan change reaches your account when Stripe’s webhook arrives, not when the
browser comes back from checkout — normally a second or two.
What a smaller plan does to your machines
Nothing is deleted, and no files are touched. Deleting somebody’s computer because a card expired is not a thing this platform does. What changes is which machines are allowed to keep running, and the rule is most recently used first. On a plan that runs three machines and now runs one, the machine you worked on yesterday keeps its slot and the other two are stopped. A stopped machine keeps its whole filesystem and starts again where it left off. Dropping to Free is the same rule with a different answer: the free plan keeps no machine running, so all of them go to sleep and you press Start on the one you want. That is what free offers — a machine you start when you want it, rather than a computer held warm around the clock. The machines over the limit stay in your list and stay one button from starting, so the limit is checked again when you press it:Plans
What each tier gives, and the prices from the server.
Machine
What a machine is, what survives a stop, and what does not.