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.

get/order-gift-card

Request

  • Base URL: https://laso.finance
  • URL: https://laso.finance/order-gift-card
  • Auth: none declared

Query parameters

amountnumber required

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.

laso_server_idstring required

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.

countrystring

ISO 3166-1 alpha-2 country code (defaults to "US")

Response

Gift card ordered successfully

callable_base_urlstring
user_idstring

The user's ID (lowercase wallet address)

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.