# Cards

An agent on Open Solid can hold two kinds of card. Use a **reloadable card** for anything recurring, and a **prepaid card** for a single checkout.

## Reloadable cards

One card, many charges. Put it on file with ad platforms and SaaS tools, and top it up from the wallet as revenue lands. Reloadable cards need a one-time identity check by the account owner, done in the dashboard.

### Create one

```bash
curl -X POST https://laso.finance/create-reloadable-card \
  -H "Authorization: Bearer $LASO_ID_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"usd_amount": 50}'
```

Creating a card is free. Cards are reusable by default; pass `"reusable": false` for a card that closes after its first approved charge. A `402` means the card balance is short, so fund it and retry. A `400` means the owner hasn't finished card setup in the dashboard.

### Top it up

```bash
curl "https://laso.finance/fund-card-balance?amount=150" \
  -H "Authorization: Bearer $LASO_ID_TOKEN"
```

No fee. The full amount lands on the card balance.

### List cards and transactions

```bash
curl "https://laso.finance/get-card-data?card_type=Reloadable" \
  -H "Authorization: Bearer $LASO_ID_TOKEN"
```

Each card returns `card_id`, `last4`, `expiry`, `balance`, `spend_limit`, `reusable` and `status` (`open`, `paused` or `closed`). `GET /list-card-transactions` returns its charges.

## Prepaid cards

A U.S. card loaded once for an exact amount, from $5 to $1,000, with no fee. It's issued in seconds. Good for a domain, a one-off purchase, or a merchant you don't want to leave a reloadable card with.

```bash
# Paid over x402: the price is the amount on the card
curl "https://laso.finance/get-card?amount=32"

# Then poll until status is "ready" (usually 7-10 seconds)
curl "https://laso.finance/get-card-data?card_id=crd_..." \
  -H "Authorization: Bearer $LASO_ID_TOKEN"
```

Prepaid cards work at U.S. merchants, and physical goods must ship to a U.S. address. For non-U.S. merchants, use the international prepaid card (`GET /order-intl-card`, $100 to $1,000, queued and usually fulfilled within 24 hours).

## Check the merchant first

Before ordering a card for a specific store, search the acceptance database. It's free:

```bash
curl "https://laso.finance/search-merchants?q=pinterest" \
  -H "Authorization: Bearer $LASO_ID_TOKEN"
```

`accepted` means it has worked there, `not_accepted` means it was declined, and `unknown` means a past attempt was unclear. A merchant that isn't listed simply hasn't been tried yet.