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

# Auto top-up

> Automatically add prepaid credit when your API balance runs low.

Auto top-up charges your saved card and adds prepaid credit when your API balance falls below a threshold you choose.

The feature is off by default. An organization admin can open **Developers**, select **Billing**, then manage it from **Auto top-up**.

## How it works

1. Save a card from the billing page and make it your default payment method.
2. Turn on **Enable Auto top-up**.
3. Enter a **balance threshold**: the balance below which a top-up can run.
4. Choose a **top-up amount**: \$10, \$25, \$50, \$100, or a custom amount from \$10 to \$5,000. The threshold must be lower than this amount.
5. Check the **monthly limit**. It starts at three times the top-up amount, capped at \$10,000. You can change it, but it must cover at least one top-up.
6. Select **Save Auto top-up** to authorize automatic charges to your saved card.

Auto top-up is available for prepaid accounts. It always uses your organization's billing card, including when you are viewing Sandbox in the dashboard.

## Monthly spending and limits

**This month** shows the amount charged automatically against your monthly limit. The limit resets each UTC calendar month. A top-up that would exceed it is not charged. Manual top-ups do not count toward this limit.

Balance checks run periodically, so a top-up is not instant. If your credit runs out before the top-up arrives, or after you reach the monthly limit, API requests stop until credit is available again. You can add credit manually from the billing page.

## Emails you receive

Every active organization admin receives these notifications:

1. **Top-up receipt:** amount, updated balance when available, card details, monthly total, and monthly limit
2. **Monthly limit reached:** sent once per organization each month when another top-up would exceed the limit
3. **Auto top-up paused:** explains what to do when the card is declined, requires authentication, or cannot be used

Stripe also emails a payment receipt for the card charge.

## Pause and resume

A card problem pauses Auto top-up. The panel shows **Paused** and explains why. Nothing retries while paused.

Update or replace the saved card, then save the settings again with Auto top-up enabled.

## Turn it off

Turn off **Enable Auto top-up**, then select **Save Auto top-up**. Jinko keeps the saved settings for later. Turning it off does not refund earlier top-ups.


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