Top-ups and Invoicing

Top-ups and invoicing on Bahriya: pay-as-you-go credit, auto top-up, saved payment methods, invoice billing, and the emails sent about your balance.

Updated 8 Jun 20263 min read

Bahriya supports two billing modes: pay-as-you-go (PAYG) and invoice. This article explains how each works, how to add credit, and what happens when your balance runs low.

Pay-as-you-go (PAYG)

PAYG is the default billing mode. You add credit to your account and usage is deducted from your balance in real time.

Adding credit (top-ups)

You can top up your balance from the Billing page in your organisation settings. Enter an amount and complete the payment through the checkout flow. Payments are processed via Stripe — Bahriya does not store your card details directly.

You can also save a payment method for future use during checkout.

Auto top-up

To avoid running out of credit, you can enable auto top-up:

  • Threshold — When your balance drops below this amount, a top-up is triggered automatically.
  • Amount — How much credit to add each time.

For example, set a threshold of $20 and an amount of $100 — whenever your balance drops below $20, $100 is charged to your saved payment method automatically.

Auto top-up requires a saved payment method set as default.

What happens when your balance runs out

If your balance reaches zero and there is no auto top-up configured:

  • Your resources may be suspended until credit is added.
  • Suspended containers stop serving traffic but are not deleted. Your configuration, secrets, and data remain intact.
  • Once you add credit, resources resume automatically.

Managing payment methods

From the Billing page you can:

  • Add a new payment method.
  • Set a default payment method (used for auto top-up).
  • Remove a saved payment method.

Invoice billing

Invoice billing is available for organisations with higher usage or specific requirements. In this mode:

  • Usage is tracked and billed on a monthly cycle.
  • You receive an invoice at the end of each billing period.
  • Payment terms are agreed when invoice billing is set up.

Invoice billing is configured by the Bahriya team — contact support to request it.

Emails we send about your balance

Three billing emails go to your organisation's email address:

  • Your balance is running low — sent once when your balance drops below a warning level while you are still in credit. It is a heads-up, not a problem: nothing has stopped working. You are warned again only after the balance recovers and drops a second time, so the same warning will not arrive day after day.
  • Your invoice has been issued — sent when a monthly invoice is produced. On PAYG the invoice is already settled from your balance, so it reads as a statement of what you used rather than a request for payment. On invoice billing it carries the amount due and the date it is due by.
  • Payment received — sent when a top-up or a settlement completes.

If your balance goes negative, a different set of emails takes over: reminders while the account is overdrawn, and a notice if containers are suspended. Those are covered above.

Note

All of these go to the organisation's email address rather than to individual members, so they are not affected by the personal email preferences on your profile. See Choosing which emails you receive.

Billing portal

From the Billing page, you can access the billing portal to view your payment history, download receipts, and manage your billing details.