Quickstart

Enable billing, configure a payment provider, create your first plan, and run a test purchase.

Five steps from zero to your first paid server.

1. Enable billing

Go to Admin → Billing → Settings and toggle billing on. Pick a default currency (an ISO code like USD or PLN) and, if you like, an invoice prefix such as INV-. The /billing page and the wallet become visible to users immediately.

2. Configure a payment provider

Open Admin → Billing → Providers and fill in one of the built-in providers.

Stripe — you'll need the publishable key and secret key from the Stripe Dashboard (Developers → API keys) and the webhook signing secret (Developers → Webhooks → your endpoint). Point Stripe's webhook at:

https://your-panel.example.com/api/billing/webhook/stripe

SimPay — enter the API password (merchant panel → API) and your service ID (merchant panel → Services). Point SimPay's webhook at:

https://your-panel.example.com/api/billing/webhook/simpay

Save, and users will see the provider as a top-up option in their wallet.

3. Create a category and a product

Open Admin → Billing → Catalog. A category groups related plans — give it a name, a description, and optionally an icon and banner image. Inside it, create a product: set its resource limits (CPU, RAM, disk, and more) and add one or more pricing tiers, each with a duration (7 days to a year) and a price. Every tier of a product provisions the same limits — only the price and period change.

4. Top up and buy

As a regular user, open /billing/wallet and top up through a provider. Once the webhook lands, the balance updates. Then visit /billing, pick a category, and walk through the purchase wizard. A server appears in the user's server list with the plan's limits applied.

5. Verify

On the user's page (Admin → Users → [user]) the new subscription should show as active with the right dates, linked to the server.

For local testing you can skip the provider entirely: adjust a user's wallet balance directly from their page.

On this page