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

# Wallet & balance

> Your wallet holds your cards; your balance is the cash that funds them

Your **wallet** is the container of your cards, like Apple Wallet. Your **balance** is the cash that funds new cards — held in USDC, but you add and withdraw in USD.

## Show your wallet

```bash theme={null}
agent-cards wallet
```

Shows the cards in your wallet, then your balance (with any deposit still settling). The first run provisions everything automatically.

## Check your balance

```bash theme={null}
agent-cards balance          # your cash balance (add --json for scripts)
agent-cards balance <cardId> # one card's remaining balance
```

## Add cash

```bash theme={null}
agent-cards fund --amount 50
```

| Option               | Description                                                                                                                                                                       |
| -------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `--amount <dollars>` | **Required.** Amount in dollars (e.g. `50` = $50.00), up to $10,000.00. The minimum is $2.00 or $20.00 depending on your funding provider — the error tells you your exact range. |
| `--method <method>`  | `apple_pay` (default) or `google_pay`.                                                                                                                                            |

Opens a checkout page in your browser — pay with Apple Pay or Google Pay and the cash lands in your balance within minutes. First-time funding asks for a one-time verification code (sent by text or email); it stays fresh for 60 days.

<Note>
  Brand-new account? Identity verification comes first. Run `agent-cards cards create` — it walks you through identity (ID photo + a short face scan), sends the one-time code, and funds your balance in the same flow. After that one-time step, `agent-cards fund` works directly.
</Note>

## Redeem a promo code

```bash theme={null}
agent-cards redeem SUMMER25   # the credit lands in your balance
agent-cards codes             # your code history: used, processing, retryable
```

Each code works once per user. The credit becomes spendable within a minute or two; `agent-cards balance` shows it land. If a redemption fails mid-transfer, nothing is consumed: `agent-cards codes` marks it retryable and you can run `redeem` again with the same code. Both commands take `--json` for scripts.

## Withdraw

```bash theme={null}
# To your bank account (picks a saved account, or walks you through adding one)
agent-cards withdraw --amount 25

# As USDC on Base, to an address you control
agent-cards withdraw --amount 25 --to 0xYourWallet...
```

| Option               | Description                                                       |
| -------------------- | ----------------------------------------------------------------- |
| `--amount <dollars>` | **Required.** Amount in dollars, $2.00 to $10,000.00 per request. |
| `--to <address>`     | Send USDC on Base to this `0x` address instead of a bank account. |

Withdrawals are **processed by our team**, usually within **1-3 business days** — you get an email when the request is received and another when it's sent. Open requests hold your balance until they complete, so you can never over-request.

**Bank accounts** are saved once and reused: US accounts use ACH (routing + account number), everywhere else uses an international wire (IBAN + SWIFT). Some countries need one extra identifier — the CLI prompts for it (IFSC in India, CLABE in Mexico, BSB in Australia). Account numbers are masked everywhere after saving.

**Crypto withdrawals** go to any address on Base — double-check it, crypto transfers can't be reversed. Agentcard-managed addresses are rejected.

If you connected through a company's app and withdrawals are unavailable, that company has disabled them — contact them.

<Note>
  The older spellings `agent-cards wallet fund` and `agent-cards wallet withdraw` keep working as aliases.
</Note>