Skip to main content

1. Set up your agent’s wallet

Your agent needs USDC to pay for Laso Finance API calls. If your agent does not already have a wallet, use a Laso-managed wallet. It is the whole setup: no provider signup, no private key to look after, no endpoint registration. The other tabs are for agents that already have a wallet with Locus, Sponge, or Ampersend. Those all work with every Laso endpoint, so there is nothing to migrate. If you are not already using one of them, you do not need one.
Laso custodies a Solana wallet for your account and pays x402 endpoints on your agent’s behalf, so the agent never builds a payment header or holds a private key. There is no provider signup, no API key, and no endpoint registration.Tell your agent:
All you need to do is fund it:
1

Let your agent sign in

Your agent calls GET /auth and gets its credentials. Nothing is needed from you.
2

Fund the wallet

Your agent reads its wallet address from getAgentWallet and shows it to you. Send USDC on Solana to that address. At least $5 covers a card order.
From there the agent calls agentX402Pay instead of paying endpoints directly. See the managed agent wallet guide for the full flow, including the per-payment guardrails for external endpoints.
A managed wallet can pay any x402 endpoint, not just Laso’s. Skip to step 2 below; the Locus endpoint-registration guide does not apply.

2. Order a card

Once your agent has a funded wallet, it can call the Laso Finance /get-card endpoint. The x402 protocol handles the payment flow automatically.
The response includes:
  • auth.id_token and auth.refresh_token for authenticated API calls
  • card.card_id with status: "pending"

3. Poll for card details

Card details (number, CVV, expiry) take ~7-10 seconds to become available. Poll /get-card-data until status is "ready".

4. Use the card

You now have a prepaid card. Use the card number, CVV, and expiry to make purchases at any US-based merchant.
The USA prepaid card (/get-card) is U.S. only — issued in USD, usable at U.S. merchants only, and physical goods must ship to a U.S. address. For international purchases use GET /order-intl-card instead.

Full example

Cards are non-reloadable. If you’re making an online purchase, ideally order a card for the exact checkout total so no funds are left over on the card.