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

# Auto-recharge

> Keep calls running without watching your balance: TopCalls buys credit on your card when it runs low, up to a monthly limit you set.

Auto-recharge charges your saved card when your available credit falls below an amount you choose, so a long campaign doesn't stop halfway through a list. A monthly limit caps what auto-recharge can charge in one calendar month. It's off until you turn it on.

## Turn it on

You need permission to manage billing.

**1. Open Billing**

Go to **Settings > Billing** and select **Auto-recharge** next to your credit balance. The button shows **On**, **Off** or **Paused**.

**2. Set When below**

The amount that triggers a top-up. When your available credit (starter and purchased credit, minus what calls in progress hold) falls below it, we charge the card. If you pay for extra call slots, the slot fee due on the 1st is added to this amount, so the top-up covers it too.

**3. Set Add**

The amount each top-up buys. The minimum is $100. **When below** and **Add** can each be at most $10,000. When one top-up isn't enough to get back above **When below**, one charge buys as many top-ups as it takes.

**4. Set the Monthly limit, or leave it empty**

The most auto-recharge can charge in one calendar month (UTC). Empty means the default: 10 times your top-up. With a $100 top-up, that's $1,000 a month. The limit must be at least one top-up.

**5. Save**

Switch on **Enabled** and select **Save**.

## Watch the month

Once it's on, the same window shows **This month**: how much auto-recharge has charged so far against your limit.

When the next top-up would go over the limit, auto-recharge charges only the whole top-ups that still fit. When not even one fits, it pauses until the 1st of next month (UTC). Then:

* The button shows **Paused**, and the window says until when.
* Everyone who manages billing gets one email that month, with links to **Add credit** and to raise the limit.
* Calls keep running on the credit you have. When it runs out, calls stop as they would without auto-recharge.

To start auto-recharge again this month, select **Raise limit** and save a higher limit. To keep calls running without raising it, add credit by hand. On the 1st, the month resets and auto-recharge picks up by itself.

## When the card fails

If a charge fails, auto-recharge tries again, at most once every five minutes. The company owner gets an email on the first failure and again if auto-recharge switches off. After three failed charges in a row it switches itself off. Update the card in the billing portal, then turn auto-recharge back on: that resets the count. Reaching the monthly limit isn't a failure and doesn't add to the count.

## What auto-recharge doesn't cover

The only monthly charge auto-recharge plans for is extra call slots. It doesn't count [browser dialer](https://docs.topcalls.ai/guides/browser-dialer.md) seats or other charges due on the 1st when it decides to top up. Add credit yourself before the 1st if they need it.

## Through the API

`GET /v1/balance` returns `auto_recharge` with `enabled`, `floor_micros`, `topup_micros` and `consecutive_failures`. The monthly limit is set in the dashboard only. See [Credit](https://docs.topcalls.ai/concepts/credit.md) for how credit works.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.