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

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

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

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.

# 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:

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.