Manage a subscription and paid add ons

Open Settings → Subscription for the authoritative workspace subscription view. Only a workspace Super Admin can start or change platform billing. Other administrators can see selected plan facts but do not receive provider billing controls.

#Start a subscription

When the workspace has no live platform subscription, select a plan and any paid workspace add ons to include. agaro sends the selected catalog keys to the server, which resolves the configured provider price identifiers and active member quantity.

The hosted Stripe Checkout page is the authority for the amount, billing interval, quantity, trial, and payment method. Review it before completing checkout.

After returning to agaro, signed Stripe events reconcile the local subscription. Do not assume the return URL alone proves payment or activation.

#Read the current plan card

The Subscription page shows:

• Plan name
• Provider status
• Trial time remaining where applicable
• Current period end
• Active paid add ons
• Billing management actions for authorized users
• AI credit controls
• Agency billing contract information for agency managed clients

Common statuses include Trialing, Active, Past due, Canceled, Incomplete, Unpaid, and Exempt.

#Use the billing portal

For an existing provider subscription, select Manage billing. Plan changes, payment methods, provider invoices, and cancellation are handled in the Stripe hosted billing portal.

Return to the agaro Subscription page after a portal change and allow reconciliation to update access.

#Add a paid add on

For an inactive add on, select Add add on. agaro updates the existing Stripe subscription and then waits for provider truth to reconcile before presenting it as current access.

If the workspace is starting its first subscription, select the add on before checkout so the plan and add on enter the same hosted session.

The add on must be configured in the platform catalog. A visible but unconfigured add on cannot be purchased.

#Remove a paid add on

Select Remove and approve the confirmation. Removing an add on changes recurring billing and can remove access to its module family after reconciliation.

Before removal:

1. Export or review operational records that depend on the module.
2. Stop scheduled sends, automation, or publishing activity in that family.
3. Confirm teammates understand the access change.
4. Approve the provider billing change.

Removal does not promise permanent erasure of every record created by the module. Use the product's data and privacy controls for deletion requests.

#Reconcile billing state

The paid add on card can show a target change while provider reconciliation is pending. Use the reconciliation control when available. A result stating that billing already reflects the add on means no second provider update was created.

If the card reports Billing issue, support required, ordinary add or remove controls are intentionally hidden. Contact support rather than trying repeated checkout or portal changes.

#Past due and read only access

A past due subscription displays a warning and the provider grace deadline when one exists. Update the payment method in the billing portal.

After the allowed access window, the workspace can become read only. Users may still read supported data, while create, update, delete, assistant turns, and API mutations are refused. Subscription checkout and billing portal recovery actions remain available so a Super Admin can restore access.

#Canceled or unpaid subscriptions

Canceled and unpaid states do not grant normal paid access. Restore the provider subscription from the available billing surface. If the provider portal no longer offers recovery, start the supported subscription checkout flow rather than creating a second customer manually.

#Agency managed client workspaces

A workspace managed under an agency does not buy the agaro platform plan directly. Its Subscription page states that platform billing is managed by the agency.

The same page can show a separate agency client billing offer. The client Super Admin reviews the immutable price lines and accepts through the agency's connected Stripe Checkout. This is a payment to the agency, not a second agaro platform plan.

#Exempt workspaces

An explicitly exempt workspace receives access without a normal provider charge. The platform owner workspace is always exempt. Exemption state is controlled by platform authority and cannot be self assigned.

#Troubleshooting

#Checkout returned but the plan still says inactive

Refresh the page and wait for the signed provider webhook. Keep the checkout reference. Do not start repeated sessions until you know whether the first session completed.

#Manage billing is missing

Only the Super Admin can manage platform billing. Agency managed, exempt, or not yet subscribed workspaces can also have a different billing path.

#Removing an add on did not immediately hide the module

Provider reconciliation is asynchronous. The module can remain installed while paid access becomes unavailable. The entitlement state, not the presence of the sidebar row, is the authority.

#The workspace is read only

Open the billing portal from Subscription, update the payment method or restore the subscription, then return and wait for reconciliation.