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

# Auto-recharge

> When your balance dips below a threshold you set, we charge your saved card and top it back up, no one in the loop.

Auto-recharge is the difference between a prepaid balance and an outage risk: without it, traffic stops with a `402` the moment credits run out; with it, a dip below your threshold triggers an automatic, off-session charge to the card on file. Setup is three steps on the [Billing](https://platform.pearlresearch.ai/billing) page (billing admins only):

**1. Save a card**

**Add a card** opens a Stripe-hosted setup page, the card is saved with a mandate for merchant-initiated charges and, like all payments here, never touches Pearl's servers. The card on file (brand and last four digits) is always visible on the Billing page, and **Replace card** swaps it at any time.

**2. Set your threshold and amount**

* **Recharge when balance is below**, minimum \$10. A recharge is not instant: your card is charged and the credit lands once the payment settles, which can take a few minutes, so the threshold has to leave room for the traffic you serve meanwhile, or your balance can drop below \$0 first. For steady production loads, a day's spend is a sensible floor.
* **Recharge amount**, minimum \$5, the same bounds as a manual top-up. Larger amounts mean fewer charges (and fewer card-decline opportunities). Where tax such as VAT applies, it is added on top of this amount, and your balance is credited the amount you set.

**3. Enable it**

Flip the toggle and save. The switch only arms once a card is on file. The Billing page shows the last time an auto-recharge ran, and every automatic charge lands in payment history marked **Auto**, with the failure reason if a charge declines.

## What to expect

* Detection is balance-driven, not schedule-driven: the charge fires when the balance crosses your threshold, so quiet weeks cost nothing.
* If a charge fails (expired card, insufficient funds), the balance keeps draining toward zero, watch payment history for **Failed** entries, fix the card, and top up manually if needed. Failures don't retry your traffic away; only an empty balance does.
* Auto-recharge applies to prepaid accounts only, [invoiced (enterprise) accounts](/docs/credits.md) never need it.

> [!TIP]
>
> Belt and suspenders for production: auto-recharge on, plus a `402` alert in your own monitoring (see [error handling](/docs/inference.md)). The first tells you the system is working; the second tells you the moment it isn't.


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