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-managed (start here)
- Locus
- Sponge
- Ampersend
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 third-party provider signup and no endpoint registration.Tell your agent:All you need to do is fund it:From there the agent calls
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.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.
auth.id_tokenandauth.refresh_tokenfor authenticated API callscard.card_idwithstatus: "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
Next
Making a purchase
Buy something online with the card your agent just ordered.