Skip to main content

Subscriptions & Billing Sources

The Organizations & Plans page (/admin/orgs) shows one row per organization with four columns that describe what plan an org is on and where that plan came from. The badges are deliberately different shapes, and the difference matters: it tells you whether a subscription row exists at all, and whether you or your payment gateway owns it.

Plan

The plan the organization is entitled to.

BadgeMeaning
(none)The org has its own subscription row pointing at this plan.
DefaultThe org has no subscription row. Entitlement resolves to whichever plan you marked as the default plan, so the org is genuinely on that plan — it just has nothing recorded of its own.
InternalThe org is on the reserved Internal tier, which bypasses billing and grants everything your platform tier permits.

Status

This is where the shape of the badge carries the meaning.

  • A solid badge shows the status of a real subscription row — active, canceled, or whatever state the row is in. Canceled rows are shown in red.
  • A pale / outlined active badge means there is no subscription row. The org is entitled and usable via your default plan, so calling it "no subscription" would be wrong — but nothing is recorded for it, so nothing can be canceled, renewed, or charged.

If you have wondered why one active badge looks fainter than another, that is the whole difference: solid means "there is a row", pale means "entitled by default".

Source

Where the subscription came from, and therefore who may change it.

BadgeWhat it meansWho owns changes
DefaultNo subscription row; entitled via the default plan.Nothing to own yet. Assigning a plan creates a manual row.
ManualA row you created by hand. It carries the manual sentinel instead of a gateway customer reference, so the payment gateway was never involved and no charge exists.You, from this console.
GatewayA row that carries a gateway subscription ID — the customer subscribed and pays through your payment gateway.The gateway. This console is read-only for these rows.
FreeA row on your default plan with no gateway subscription ID and no manual marker. Created automatically when the organization signed up: a free plan has nothing to charge, so nothing was created at the gateway.You, by changing the plan.
Gateway rows are read-only here

Cancel or modify gateway-backed subscriptions on your payment gateway admin, never directly in this console. Editing them in both places is how the database and the gateway drift apart.

Changing a plan

Change plan on any row sets the organization's plan directly in the database, creating a Manual subscription if none exists. It bypasses the payment gateway, which is what makes it right for employees, partners, and test accounts — and wrong for a paying customer whose subscription the gateway already owns.

Manual subscriptions carry their own period end, which you can extend from the same page. Nothing renews them automatically, because nothing is charging for them.

Owner email badges

Two badges can appear under an owner's address:

  • Email unverified — the owner has not confirmed their address yet.
  • Email bounced — mail to this address bounced or was reported as spam within the last 30 days. The address is effectively undeliverable: password resets, invoices, and alerts will not reach this person until it is fixed.

Both are about reaching the owner, not about their plan. See SMTP Setup for how platform mail is sent.