Billing & Subscription

The Billing section of the Console lets you manage your Auris subscription plan, initiate or change a subscription, view past invoices, and access the Stripe Customer Portal for payment method and invoice management.

Access it from the sidebar: Settings → Billing.

Overview

Every Auris tenant is on a subscription plan. The plan determines which features are available in your tenant and how many resources (users, applications, organizations, SSO connections) you can create.

When you first create a tenant, you are automatically placed on the Free plan. No payment information is required to get started. You can upgrade to a paid plan at any time from the Billing page.

Plans are billed monthly or yearly. The Console defaults to showing prices in EUR; use the currency selector on the Billing page to view equivalent amounts in USD, GBP, or CHF. Prices displayed in non-EUR currencies are indicative conversions — your Stripe invoice is always denominated in the currency selected at checkout.

Available Plans

The following plans are available. Limits marked Unlimited have no enforced cap.

Feature availability is enforced in real time by the Auris feature gate. Attempting to use a feature not included in your current plan returns HTTP 403 with a reason identifying the required plan.

Resource limits (MAU, organizations, SSO connections) are enforced when creating new records. Existing records are never automatically deleted when you downgrade — you will need to reduce counts manually before the new lower limit becomes the active ceiling.

For the Enterprise plan or custom volume pricing, use the Contact Sales button on the Billing page.

Subscribing

If your tenant is on the Free plan, the Billing page shows a plan selector. To subscribe to a paid plan:

Changing Plans

Upgrades and downgrades are applied immediately with prorated adjustments.

Proration behavior

Feature access changes immediately on plan change. The in-memory feature cache for your tenant is invalidated as soon as the change is recorded, so limits and feature flags reflect the new plan within seconds.

Cancellation

Cancellation schedules your subscription to end at the close of the current billing period. You retain full access to your plan’s features until the period ends.

What happens at period end

When the billing period closes:

• Your Stripe subscription is deleted.
• Auris downgrades your tenant to the Free plan automatically.
• Features and limits revert to the Free tier immediately.
• All data is retained — users, applications, organizations, and audit logs are not deleted.

Resuming a Cancelled Subscription

If you have scheduled a cancellation but the billing period has not yet ended, you can reverse the cancellation and keep your current plan.

Your subscription continues as normal from that point forward. No new charge is issued — you simply continue on the existing billing cycle.

Billing History

The History tab on the Billing page lists your past invoices sourced directly from Stripe.

Up to 100 invoices are shown (default: 20). Use the Load More button if available to fetch additional records.

If your tenant has not yet had a paid subscription, the History tab shows an empty state.

Stripe Customer Portal

For payment method changes, invoice history with full PDF downloads, and address or tax ID management, use the Stripe Customer Portal.

Permissions

The Billing page is restricted to users with the appropriate permissions on the tenant.

Assign these permissions via Settings → Users & Roles. See Users & Roles for details.

The public plan list (GET /api/billing/plans) requires no authentication and can be fetched by unauthenticated callers, for example to display pricing information on a public page.

Webhook Processing

Auris receives payment lifecycle events from Stripe via a webhook endpoint. This is handled automatically — no configuration is required from the Console. The following events update your subscription state:

If your subscription shows as Past Due, update your payment method in the Stripe Customer Portal to resolve the outstanding invoice. Auris will re-activate the subscription once Stripe confirms payment.

Feature Gate and Limit Errors

When your code or Console action hits a plan limit, the API returns a structured error response.

Feature not available on plan (HTTP 403)

{
  "ok": false,
  "error": {
    "code": "FEATURE_NOT_ALLOWED",
    "message": "Feature 'sso' is not available on your current plan.",
    "upgradePlan": "pro"
  }
}

Resource limit exceeded (HTTP 402)

{
  "ok": false,
  "error": {
    "code": "LIMIT_EXCEEDED_ORGANIZATIONS",
    "message": "Organization limit reached for your current plan.",
    "current": 5,
    "limit": 5,
    "upgradePlan": "business"
  }
}

The upgradePlan field in both responses identifies the lowest plan that would allow the action. Use this to present a targeted upgrade prompt in your application UI.

Related

• Licensing Console — Issue and manage license keys for your own products (separate from your Auris subscription)
• Users & Roles — Assign view:billing and manage:subscriptions permissions
• Organizations — Organizations are a plan-gated feature; see limits by plan above
• Enterprise SSO — SSO connections are gated by plan