Billing and balance

DomainGenius runs on a prepaid balance. Registrations, renewals, and transfers debit the balance. There’s no per-action card charge in the steady state.

Top up

Dashboard → Billing → Top up. Pick an amount, pay with card.

Via API:

curl -X POST "https://api.domaingenius.com.au/api/v1/orgs/$DG_ORG/billing/deposit" \
  -H "Authorization: Bearer $DG_KEY" \
  -d '{ "amount_cents": 10000 }'

The response carries a Stripe checkout URL — open it for the user.

Auto-top-up

Configure in the dashboard or:

curl -X PATCH "https://api.domaingenius.com.au/api/v1/orgs/$DG_ORG/billing/auto-topup" \
  -H "Authorization: Bearer $DG_KEY" \
  -d '{
    "enabled": true,
    "threshold_cents": 5000,
    "amount_cents": 20000
  }'

Once the balance drops below threshold_cents, we charge the saved default card for amount_cents. Failed charges trigger balance.low webhooks and an email.

Default card

Add or update via the Stripe billing portal:

curl -X POST "https://api.domaingenius.com.au/api/v1/orgs/$DG_ORG/billing/portal" \
  -H "Authorization: Bearer $DG_KEY"

The response has a portal URL. Card data never touches our servers — Stripe holds the PAN; we hold a payment method id.

Transactions and invoices

curl "https://api.domaingenius.com.au/api/v1/orgs/$DG_ORG/billing/transactions?limit=50" \
  -H "Authorization: Bearer $DG_KEY"

Each row is an immutable ledger entry — top-up, debit, refund, adjustment. Sum the column to derive the balance.

Tax-compliant invoices for top-ups are PDFs available from the dashboard. We’re GST-registered in Australia; invoices include ABN and tax breakdown.

Refunds

Failed registrations refund automatically — the debit ledger row is paired with a same-amount credit. You’ll see both rows in the transaction list.

For voluntary refunds (e.g. you topped up and changed your mind), email billing@domaingenius.com.au. We refund unspent balance to the original payment method, less any Stripe fees we paid.