Skip to main content

​
Overview

Laso Finance prepaid cards go through a simple lifecycle: order, wait for details, spend, and deplete. Cards are non-reloadable — once the balance is used up, the card is done. But you can make multiple purchases until the balance hits zero.

​
Lifecycle stages

Order card          Poll for details       Spend              Depleted
───────────►  ──────────────────►  ──────────────►  ────────────►
 /get-card        /get-card-data       Use card         Balance = 0
 (pay USDC)     (status: pending     details at        Card is
                  → ready)           any US merchant    finished

​
1. Order

Call GET /get-card?amount=50 with an x402 payment. The amount you pay in USDC is the amount loaded onto the card (between $5 and $1,000). The response returns immediately with:
  • card.card_id — Unique identifier for this card
  • card.status — Always "pending" at this point
  • auth.id_token — Bearer token for polling

​
2. Pending

The card has been ordered but the details aren’t ready yet. This stage lasts ~7-10 seconds while the card is being issued by the card network. During this time, poll GET /get-card-data?card_id=X with your Bearer token every 2-3 seconds. 
{
  "card_id": "O-01ABC123",
  "usd_amount": 50,
  "country": "US",
  "status": "pending"
}

​
3. Ready

Once status changes to "ready", the response includes full card details: 
{
  "card_id": "O-01ABC123",
  "usd_amount": 50,
  "country": "US",
  "status": "ready",
  "card_details": {
    "card_number": "4111111111111111",
    "exp_month": "12",
    "exp_year": "2027",
    "cvv": "123",
    "available_balance": 50.00
  }
}

​
4. Spending

Use the card number, expiry, and CVV to make purchases. The card works at any US-based merchant — online, in-store, or via mobile wallets. You can make multiple purchases until the balance is depleted. Each purchase reduces the available_balance.

​
5. Depleted

When the balance reaches zero, the card can no longer be used. Order a new card with another /get-card call.

​
Key details

PropertyValue
Card typePrepaid
CurrencyUSD
RegionUS only
Minimum load$5
Maximum load$1,000
ReloadableNo
Multiple purchasesYes, until balance is depleted
Time to issue~7-10 seconds

​
Restrictions

Cards are US only. They can only be used at US-based merchants for USD purchases. Physical goods must ship to a US address. The card is intended for the caller’s own use and is non-transferable.

​
Polling best practices

  • Poll every 2-3 seconds — don’t hammer the endpoint
  • The card is typically ready within 7-10 seconds
  • If still pending after 30 seconds, something may be wrong — log the card_id and contact support
  • Always check the status field before reading card_details