> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hyzl.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Credits & Billing

> How AI Receptionist credits work and how to manage your balance.

## How credits are used

AI Receptionist deducts **one credit per answered call**, regardless of how long the call lasts. A 10-second call and a 10-minute call both cost the same: one credit.

| Outcome                                                           | Credits Used |
| ----------------------------------------------------------------- | ------------ |
| Caller answered, full conversation                                | 1            |
| Caller answered, hung up immediately                              | 1            |
| Call dropped because balance was empty + auto top-off unavailable | 0            |

## View your balance

Your account balance and usage breakdown live on the **Billing** tab in your account. Click the gear icon at the bottom of the sidebar to open Settings. Then choose **Billing**.

## Monthly allotment

Your subscription includes a monthly call allotment. This resets on your billing cycle date. Unused credits do not carry over.

## Per-receptionist billing

Billing scales per receptionist. hyzl gives each receptionist you create its own dedicated phone number, and **hyzl bills each added number**. There is no cap on how many receptionists you can run.

* **Per-user.** Whoever creates a receptionist pays for it on their own subscription and payment method.
* **Deleting decrements billing.** Deleting a receptionist releases its number and reduces your bill. Deleting your last receptionist cancels the subscription.

See [Manage multiple receptionists](/docs/ai-receptionist/managing-receptionists) for the full flow.

## Auto Top-Off

AI Receptionist supports automatic top-off so you never miss a call due to an empty balance:

1. Open your receptionist's **Settings** page
2. Find the **Automatic Credit Top-Off** section
3. Turn on **Enable automatic credit top-off**
4. Attach a card with **Set Payment Method** (or **Update Payment Method** to change it)

When your balance runs low, the portal automatically charges your payment method and adds credits. The threshold and top-up amount are managed by hyzl, not configured by you. You receive an email confirmation each time a top-off occurs.

## Buy more credits

To buy credits manually, click the **Buy Credits** button at the bottom of the sidebar.

## Failed payments

If an auto top-off charge fails, the portal displays a warning banner. The banner warns that future calls may be dropped until you fix the issue. Your balance can reach zero while auto top-off is turned off, or while its last charge has failed. In either case, the portal kills incoming calls mid-call with an error message instead of answering them.

The banner shows a specific failure reason so you can take the right action:

| Reason                                           | What it means                                                                  | What to do                                                                                                           |
| ------------------------------------------------ | ------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------- |
| **No payment method set for automatic top-offs** | Auto top-off is turned on but no card is attached as the payment method for it | Click **Set Up Auto Top-Off** in the banner to attach a card                                                         |
| **Your card was declined**                       | The most recent charge attempt was rejected by the issuer                      | Click **Update Payment Method** in the banner to swap in a working card, then retry the charge from the billing page |
| **An internal error occurred**                   | The charge attempt hit a transient system error                                | Retry the charge from the billing page; if it keeps failing, contact support                                         |

Each failure has its own dismiss state. Once you fix the underlying issue, the banner stays gone for that incident. A fresh failure shows the banner again, so you do not miss it. An example is a new declined charge a week later.