Order a gift card
Pay USDC via x402 to order a gift card. First browse the catalog via GET /search-gift-cards to find the laso_server_id for the card you want, then call this endpoint with the amount and product ID.
Pricing: amount is the card's face value in the product's own currency, not USD. Laso converts it to USD at the current exchange rate and adds the product's fee (typically 4.8%, but it varies by product; the 402 quote is exact); that total is the x402 USDC price. A 100 SAR card costs roughly $28 USDC, not $100. Check the product's currency field in GET /search-gift-cards to see what amount is denominated in.
The $5 minimum and $9,000 maximum apply to the converted USD value, not the raw amount, so a foreign-currency amount is accepted only when its USD equivalent falls inside that range.
Returns redemption details (URL, code, and/or PIN) depending on the gift card brand.
Request
- Base URL: https://laso.finance
- URL: https://laso.finance/order-gift-card
- Auth: none declared
Query parameters
Gift card face value in the product's own currency (see the product's currency field in GET /search-gift-cards), not USD. The x402 price is this value converted to USD plus the product fee. After conversion it must be worth at least $5 and at most $9,000 USD.
The product identifier from the gift card catalog (GET /search-gift-cards). Always copy it from a search result; an id that is not in the catalog returns 404 unknown_laso_server_id. Amazon is amazon for every country, selected with country.
ISO 3166-1 alpha-2 country code (defaults to "US")
Response
Gift card ordered successfully
Example response
{
"callable_base_url": "https://laso.finance",
"gift_card": {
"currency": "USD",
"country": "US"
}
}Changes
No recorded changes to this operation across all 3 revisions of this API.