# Top-Up & Payments

Add funds to your Atlas Cloud balance — payment methods, auto top-up, receipts, and invoices

Source: https://atlascloud.ai/docs/en/billing/topup

import { Callout } from 'fumadocs-ui/components/callout';

## Adding funds

Top up at [www.atlascloud.ai/console/billing](https://www.atlascloud.ai/console/billing):

1. Go to **Top-up & Billing** in the console
2. Choose the top-up amount
3. Select a payment method and complete the checkout

- **Minimum top-up: $25** per transaction
- Payments are processed in **USD** (local payment methods may present a converted amount)
- The checkout page expires after **30 minutes** — start over if it lapses
- A verified **email address** on your account is required before topping up

**Supported payment methods:**

- **Credit/Debit Card** (Visa, Mastercard, etc. via Stripe)
- **Alipay**
- **WeChat Pay**
- **Cryptocurrency**

For large amounts or bank/wire transfer, contact [sales@atlascloud.ai](mailto:sales@atlascloud.ai).

## Auto top-up

Configure automatic recharging in the Billing settings to avoid service interruptions:

- **Trigger**: when your cash balance drops below your configured threshold (minimum **$10**)
- **Amount**: the configured top-up amount is charged to your saved card (minimum **$25**)
- **Receipts**: sent to your designated receipt email (required when enabling auto top-up)
- **Permissions**: on team accounts, requires the Finance or Admin role

The balance check runs every few minutes, and your saved payment methods are charged in your configured priority order. If a card is declined, it is deactivated for auto top-up and you are notified by email — update your payment method to restore automatic recharging.

<Callout type="info" title="Avoid interruptions">
When your balance is insufficient, new API requests are rejected with `402 Payment Required`. Auto top-up is the easiest way to keep long-running workloads uninterrupted.
</Callout>

## Managing payment methods

Manage saved cards in the Billing settings:

- Add a card through the secure Stripe setup flow
- Save multiple payment methods and set their priority order
- Auto top-up uses the configured priority order

## Receipts & invoices

- A **receipt** is issued automatically for every successful top-up. Download receipt PDFs from the top-up history in the console.
- If you need a formal **invoice**, first complete your **billing profile** (name/company, address, and tax ID) in the Billing settings, then request an invoice from the corresponding receipt. If your billing details change, invoices can be reissued.
- Your full top-up history — with linked receipts and invoices — is available in the console.

## Programmatic access

Query your balance, usage, and costs from your own tools with the [Billing Public API](/public-api).
