Back to Documentation
billing-subscription.mdRaw

Billing & Licensing — AISentinel (Portal Guide)

This guide is written for AISentinel users and tenants who manage subscriptions and offline packages via the Portal.

Quick overview

  • Cloud subscriptions (Stripe): Managed through the Portal (Upgrade/Change Plan) and billed automatically. Usage shown on the Billing page. Overage billing (if applicable) is reported to Stripe.
  • Offline packages (air-gapped): Downloadable licensed binaries that run without internet access; license files enforce entitlements locally.
  • Where to find this in the Portal: Dashboard → Billing → Subscription / Offline Licenses.

At-a-glance plan summary

These are the canonical plan defaults used by the Portal. Your tenant may be on a plan that includes finer variations — check the Billing page for your tenant’s current limits.

  • Free (tiered progression)
    • New: 100 API calls / month, 1 user
    • Active: 1,000 API calls / month, 3 users
    • Established: 5,000 API calls / month, 3 users
  • Plus (paid): 50,000 API calls / month, 10 GB storage, 10 team members
  • Pro (paid): 250,000 API calls / month, 100 GB storage, 50 team members
  • Offline — Professional (license): 25,000 API calls / day, up to 25 users, 5,000 rule evaluations / day, 100 GB/day
  • Offline — Enterprise (license): Unlimited API calls, unlimited users, dedicated SLA and white-label options

If your tenant is linked to an active Stripe subscription, the Stripe subscription determines the effective plan. Otherwise the Portal reads the Subscription selection for your tenant.

Buying or changing plans (Cloud / Stripe)

  1. Open Portal → Billing → Current Plan and click Upgrade Plan or Change Plan.
  2. Choose the plan you want and click Subscribe; the Portal will create a Stripe Checkout session and redirect you to Stripe for payment.
  3. After payment completes, the Portal will link the Stripe subscription to your tenant and display the updated plan and limits.

Notes:

  • The Portal handles the checkout flow and will attempt to connect the Stripe subscription to your tenant automatically; if you encounter issues contact Support.
  • When a Stripe subscription is canceled or deleted, the tenant is downgraded back to the Free plan.

Offline packages (air-gapped deployments)

Offline packages are intended for environments that do not have network access to AISentinel cloud services. They include a prebuilt binary (or build scripts) and a signed license file that the binary validates at startup.

How to obtain and use an offline package:

  1. In the Portal → Billing → Offline Packages, choose Professional or Enterprise offline package and click Subscribe.
  2. After successful purchase, your offline package downloads become available from Portal → Billing → Offline Licenses. Click Download on the package you purchased.
  3. Extract the delivered ZIP file on your offline host, ensure license.json is available next to the binary, and start the binary with the --license-file argument or set AISENTINEL_LICENSE_FILE.

Example:

# Extract package and run
unzip aisentinel-offline-package.zip -d /opt/aisentinel-offline
cd /opt/aisentinel-offline
chmod +x aisentinel-offline
./aisentinel-offline --license-file ./license.json

License renewals and transferring packages:

  • Portal provides a download link for renewed license files when your subscription auto-renews. You can also choose a manual renewal flow via the Portal.
  • If a license expires the offline binary will refuse to run or will run with reduced features depending on your entitlements. Renew promptly to avoid disruption.

How usage and overage work (simple explanation)

  • Your Portal Billing page shows key metrics: API calls (evaluations), storage used, and seats (team members).
  • The plan’s included quota (API calls / storage / seats) is the value used to compute whether you’re on track. Cloud subscriptions (Plus / Pro) allow overage reporting and billing via Stripe.
  • Where quotas come from: the plan limits are defined by AISentinel and displayed in the Billing page. Your tenant’s included API calls are also persisted for billing and reporting.

*** End Patch

Security & Data Privacy Considerations

  • Offline license files include signed metadata; do not share them insecurely.
  • Offline packages are intended for air-gapped environments; download and install via a secure channel, and store license files in a secure place.

Troubleshooting

  • ‘Failed to create checkout session’ — verify you were signed into the Portal, confirm your payment method, and retry the checkout. If the problem persists, contact Support.
  • Subscription not shown after payment — refresh the Billing page; if the plan does not appear after a few minutes, contact Support with your payment confirmation and tenant ID.
  • Usage or invoice seems wrong — check the Billing History on the Portal to see which periods include overages, and contact Support for billing questions.
  • Offline license expired — renew from Portal → Billing → Offline Licenses or contact your account team to get a renewed license file.

Where to go next

  • GET /api/v1/billing for a canonical programmatic plan overview
  • Billing UI: Portal → Billing for purchase and offline license downloads For offline setup and advanced configuration, see: /docs/offline_mode.md