Skip to main content

​
The pieces

Balance

Money held on your account. Renewals are taken from it, and creating a server or app with the API can be paid from it directly.

Subscription

Attached to every server, app and backup add-on. Says how often it renews — 7, 14, 30 or 90 days — what it costs, and until when it is paid.

Transaction

One payment: a top-up, a purchase or a renewal, with its status.

Payment method

How a transaction is paid — balance, card, cryptocurrency and others. GET /payments/methods lists the ones you can use.

​
Two ways to pay for something new

Servers and apps can each be created two ways. The request body is the same; only the payment differs. Paying from balance is the simplest for automation: top your balance up in the dashboard, then create without any checkout. If the balance is too low, the request is refused and nothing is charged.

​
Following an order

/status is built for polling every few seconds. When the transaction is completed, read it with GET /payments/transactions/{id} — provisionId is the id of what was created. A transaction that is never paid simply expires — nothing is built and nothing is charged. Transaction statuses: pending → processing → completed, or failed, cancelled, refunded.

​
Topping up your balance

Top up from the dashboard, under Billing, with any payment method shown there. Once there is money on the balance, creating and renewing through the API needs no checkout at all.

​
Currencies

Prices are in US dollars. You can pay in another currency where the method supports it; GET /payments/currencies lists them with their rates. Some methods only settle in one currency — the order is converted for you, and the transaction’s currency and conversionRate say what was actually charged.

​
Subscriptions

A few rules worth knowing:
  • Cancelling never cuts you off early. The server or app keeps running until the end of the period already paid for, then stops renewing.
  • Changing the period applies from the next renewal. Nothing is charged or refunded now. Shorter periods carry a small surcharge over the monthly price.
  • Upgrading charges only the price difference for the days left in the current period, and keeps the renewal date. Send "dryRun": true first to see the exact amount without paying. Downgrades are not possible.
  • Some subscriptions are billed by an external payment provider on its own schedule (supportsManagement: true). Those are managed in the provider’s portal — GET /payments/subscriptions/{id}/manage returns the link.

​
When a subscription runs out

If a renewal cannot be paid, the subscription moves to past_due and then expired. An expired server or app stops and can no longer be started; renewing it brings it back. Keep your balance topped up — or renew ahead of time — to avoid interruptions.