Skip to Content
BytePanelBytePanel

Built-in billing

Take card and PayPal payments in the panel, with no separate billing system.

With built-in billing, customers sign up, choose a plan and a game, and pay by card through Stripe or with PayPal. The server is created once the payment is confirmed. Subscriptions renew monthly.

Set it up

Choose built-in billing

Go to Admin → Settings → Billing, choose Built-in and pick your currency.

Price your plans

Open each plan under Admin → Plans and set a Monthly price. Plans without a price aren't sold.

Connect Stripe, PayPal or both

The billing settings page shows each provider's status and its webhook URL.

  1. In the Stripe dashboard, create a webhook endpoint with the URL from the settings page.
  2. Subscribe it to checkout.session.completed, invoice.paid, invoice.payment_failed, customer.subscription.updated and customer.subscription.deleted.
  3. Set these in apps/web/.env and restart the panel:
STRIPE_SECRET_KEY=sk_live_...
STRIPE_WEBHOOK_SECRET=whsec_...

To test locally, use test keys and forward webhooks with the Stripe CLI: stripe listen --forward-to localhost:3000/api/webhooks/stripe.

What happens after an order

  • Renewals: each payment is recorded with a receipt on the customer's Billing page.
  • Failed payments: the subscription shows Payment due while Stripe or PayPal retries.
  • Cancellations: the server keeps running until the end of the paid month, then it's suspended. Card subscriptions can be resumed before then.
  • Unpaid or ended subscriptions: the server is suspended. Admins can delete suspended servers from Admin → Servers.

Admin → Billing lists every subscription and the last 30 days' income.

Not included yet

Plan upgrades, free plans and refunds aren't handled in the panel yet. Stripe and PayPal can send receipts and failed-payment emails for you: turn them on in their dashboards.

Edit on GitHub

On this page