Load a reloadable card balance
Pay USDC to load the account holder's reloadable card balance at the card issuer.
Why this exists: the card issuer only accepts USDC on Base, and a Laso managed agent wallet holds USDC on Solana. Pay this route from either chain and Laso bridges the payment to your own deposit address at the issuer over Circle's CCTP, which burns on the source chain and mints native USDC on Base.
Price: exactly the amount you are loading, and exactly that amount is credited to the balance. Loading $50 costs $50 and puts $50 on the card. Laso covers Circle's bridging fee by burning slightly more than requested.
A linked card issuer account is required. The account holder sets it up at https://laso.finance/agent/dashboard/verified/card.
Delivery starts once your payment settles. The response confirms the payment and returns a top_up_id; the transfer to your card balance follows and usually lands in under a minute. A payment made on Base is already on the issuer's chain, so it is forwarded without a bridge. Watch the top-up under top_ups in GET /list-card-transactions, where status moves paid → bridging → delivered → credited and the transaction hash behind each leg appears as it lands, or poll GET /get-card-deposit-address until balance reflects it.
Follow with POST /create-reloadable-card to create a card against the balance once it has arrived.
If the top-up's status becomes failed, nothing is stranded: the USDC you paid has credited your Laso account balance. Retry, or recover it with POST /withdraw.
Request
- Base URL: https://laso.finance
- URL: https://laso.finance/fund-card-balance
- Auth: none declared
Query parameters
USD of USDC to load onto the card balance (min $5, max $10,000). The x402 price equals this amount; Laso absorbs the bridge cost.
Response
Payment settled; delivery to the card balance has started.
Example response
{
"status": "paid",
"network": "base",
"asset": "USDC",
"payment_network": "solana"
}Changes
No recorded changes to this operation across all 3 revisions of this API.