# Billing

URL: https://heaven.dev/docs/reference/billing
Updated: 2026-11-21

An organization pays for monthly capacity through its subscription, and hourly capacity and excess internet egress through its prepaid wallet.

## Read

| Request | What it does |
| --- | --- |
| [Read billing](https://heaven.dev/docs/reference/billing/view) | Read billing status and prepaid balance for the selected account. |
| [Read this month's cost](https://heaven.dev/docs/reference/billing/cost) | Read this month's costs and projected total by day and pool. |
| [List charges](https://heaven.dev/docs/reference/billing/history) | List wallet transactions by pool and hour, newest first. |

## Wallet

| Request | What it does |
| --- | --- |
| [Top up the wallet](https://heaven.dev/docs/reference/billing/top-up) | Get a card payment page to add money to your wallet. |
| [Charge your saved card](https://heaven.dev/docs/reference/billing/charge) | Charge the saved card to add money to the wallet. |
| [Set automatic top-up](https://heaven.dev/docs/reference/billing/auto-top-up) | Set or turn off automatic wallet top-ups from the saved card. |
| [Refund the wallet](https://heaven.dev/docs/reference/billing/refund) | Refund unspent paid wallet money to the original cards, newest first. |
| [Redeem an offer](https://heaven.dev/docs/reference/billing/redeem) | Apply an offer code to your account. |

## Invoices

| Request | What it does |
| --- | --- |
| [List invoices](https://heaven.dev/docs/reference/billing/invoices) | List the selected account's invoices, newest first, with links to Stripe. |
| [Pay an invoice](https://heaven.dev/docs/reference/billing/pay) | Pay an open invoice with the saved card. |
| [Read invoice details](https://heaven.dev/docs/reference/billing/details-view) | Read the account details used on invoices and receipts. |
| [Set invoice details](https://heaven.dev/docs/reference/billing/details-set) | Change the account details used on invoices and receipts. |

## Cards

| Request | What it does |
| --- | --- |
| [Start saving a card](https://heaven.dev/docs/reference/billing/card-setup) | Start a card setup and get the details needed to confirm it through Stripe. |
| [Save a card](https://heaven.dev/docs/reference/billing/card-save) | Set the account's payment card from a setup Stripe has confirmed. |
| [Open the billing portal](https://heaven.dev/docs/reference/billing/portal) | Get a Stripe link to manage the account's invoices, payment cards, billing addresses and tax IDs. |

## Limits and alerts

| Request | What it does |
| --- | --- |
| [Set the egress cap](https://heaven.dev/docs/reference/billing/egress-cap) | Set, remove or reset the monthly egress spending cap. |
| [Set the spend alert](https://heaven.dev/docs/reference/billing/spend-alert) | Set or remove a monthly spending alert for the billing owner, admins and billing contacts. |
| [Set the spending cap](https://heaven.dev/docs/reference/billing/spending-cap) | Set or remove the account's monthly spending cap. |
| [Turn usage notices on or off](https://heaven.dev/docs/reference/billing/usage-emails) | Turn egress notices on or off. |

## Contacts

| Request | What it does |
| --- | --- |
| [List billing contacts](https://heaven.dev/docs/reference/billing/contact-view) | List the additional addresses that receive account invoices and billing notices. |
| [Add a billing contact](https://heaven.dev/docs/reference/billing/contact-add) | Add an email address to receive the account's invoices and billing notices. |
| [Remove a billing contact](https://heaven.dev/docs/reference/billing/contact-remove) | Remove an email address from the account's additional billing recipients. |
