Order a gift card from the Laso catalog

Overview

Your agent can order gift cards from a multi-brand catalog (Amazon, Uber, streaming services, gaming, travel, and more) using the Laso Finance API. Ordering a gift card is a two-call flow:

GET /search-gift-cards — browse the catalog and find the laso_server_id for the brand you want.
GET /order-gift-card — pay for the card via x402 and receive the redemption details.

Unlike prepaid cards, gift cards are issued instantly: the response to /order-gift-card already contains the redemption_code, pin_code, or redemption_url your agent needs. No polling step.

How it works

Discover the catalog

Your agent calls GET /search-gift-cards (free, Bearer token) and reads the facets object in the response to learn every valid category, currency, and country value.

Search for a brand

Filter the catalog with q, country, currency, and category to find the gift card. Each result includes a laso_server_id, allowed min/max amount, and the currency for the product.

Order the card

Your agent calls GET /order-gift-card?amount=X&laso_server_id=Y as an x402 request. The USDC price is the face value converted to USD, plus the product fee.

Use the redemption details

The response contains a redemption_code, pin_code, and/or redemption_url depending on the brand. Check all three fields — different brands return different combinations.

Step 1: Browse the catalog

The catalog is large, so the workflow is “discover the filters, then filter.” A single unfiltered request returns a facets object listing every valid value for category, currency, and country.

curl "https://laso.finance/search-gift-cards" \
  -H "Authorization: Bearer eyJ..."

Then issue a filtered search using values from facets:

curl "https://laso.finance/search-gift-cards?q=amazon&country=US&category=ecommerce" \
  -H "Authorization: Bearer eyJ..."

Parameter	Description
`q`	Search query that matches the brand name (e.g. `amazon`, `uber`).
`country`	ISO 3166-1 alpha-2 code (e.g. `US`, `GB`). Returns cards available in that country plus borderless products with no restriction.
`currency`	Currency code (e.g. `USD`, `EUR`, `GBP`).
`category`	Catalog category (e.g. `ecommerce`, `travel`, `gaming`, `streaming`).

Response

{
  "gift_cards": [
    {
      "laso_server_id": "amazon-us",
      "name": "Amazon",
      "description": "Amazon.com Gift Card",
      "category": "ecommerce",
      "country": "US",
      "currency": "USD",
      "min": 5,
      "max": 500,
      "increment": "1",
      "denominations": null,
      "product_image_url": "https://...",
      "catalog_info": {
        "brand_description": "Shop millions of products on Amazon.com",
        "redemption_instructions": "Go to amazon.com/redeem and enter the code"
      }
    }
  ],
  "count": 1,
  "filters": { "query": "amazon", "country": "US", "currency": null, "category": "ecommerce" },
  "facets": {
    "categories": ["ecommerce", "travel", "gaming", "streaming"],
    "currencies": ["USD", "EUR", "GBP", "CAD"],
    "countries": ["US", "GB", "DE", "CA"]
  }
}

The min, max, increment, and denominations fields tell your agent what amounts the brand accepts. Honor them before calling /order-gift-card.

Step 2: Order the gift card

curl "https://laso.finance/order-gift-card?amount=50&laso_server_id=amazon-us" \
  -H "X-Payment: <x402-payment-header>"

amount is denominated in the product’s own currency, not USD. Laso converts it to USD at the current exchange rate and adds the product fee to compute the USDC price, so a 100 SAR card costs roughly $28 USDC rather than $100. Read the product’s currency from the catalog, and take the price your agent pays from the 402 challenge rather than assuming it equals amount.

Parameter	Description
`amount`	Gift card face value in the product’s `currency`, not USD. Must respect the brand’s `min`, `max`, and `increment` rules.
`laso_server_id`	Product identifier from the catalog (`/search-gift-cards`).
`country`	Optional ISO 3166-1 alpha-2 code. Defaults to `US`.

Response

{
  "auth": {
    "id_token": "eyJ...",
    "refresh_token": "AMf...",
    "expires_in": "3600"
  },
  "user_id": "0xabc...",
  "gift_card": {
    "card_id": "gc_abc123",
    "laso_server_id": "amazon-us",
    "amount": 50,
    "currency": "USD",
    "country": "US",
    "redemption_url": null,
    "redemption_code": "XXXX-XXXX-XXXX",
    "pin_code": null,
    "status": "completed",
    "timestamp": 1700000000000
  }
}

Field	Description
`card_id`	Internal Laso identifier for this gift card order.
`redemption_code`	The code the recipient enters at checkout to redeem the card. Present for most brands.
`pin_code`	Some brands return a separate PIN alongside the code. Present it together with `redemption_code`.
`redemption_url`	Some brands return a URL to redeem the card directly. Present this instead of (or in addition to) the code.
`status`	Should be `completed` on a successful order.

Redemption details vary by brand. Check redemption_code, pin_code, and redemption_url — different brands return different combinations.

Tell your agent

Order a \$50 Amazon gift card

Order a \$50 Amazon gift card from Laso Finance. First call
GET https://laso.finance/search-gift-cards?q=amazon&country=US with the
Bearer id_token to find the laso_server_id. Then call
GET https://laso.finance/order-gift-card?amount=50&laso_server_id=<id>
via x402. Save the redemption_code from the response.

Browse categories before ordering

Browse the Laso Finance gift card catalog. Call
GET https://laso.finance/search-gift-cards with the Bearer id_token. Read
the facets object to see every valid category, currency, and country. Pick
a category, then call search again with category=<value> to list cards in
that category. Show me the brands and prices before ordering.

Order a non-USD gift card

Order a £25 gift card for <brand> on Laso Finance. Call
GET https://laso.finance/search-gift-cards?q=<brand>&country=GB&currency=GBP
to find the laso_server_id. Confirm the min/max/increment match £25, then
call GET https://laso.finance/order-gift-card?amount=25&laso_server_id=<id>&country=GB
via x402.

Limits and pricing

Property	Value
Minimum amount	$5 USD after conversion (or brand-specific `min` from the catalog)
Maximum amount	$9,000 USD after conversion (or brand-specific `max` from the catalog)
Pricing	Dynamic — the face value converted to USD, plus the product fee (up to 4.8%)
Increments	Brand-specific — respect `increment` and `denominations` from the catalog
Fulfillment	Instant — redemption details are returned in the order response

Each brand has its own allowed range and increment. Calling /order-gift-card with an amount outside the brand’s min/max or that doesn’t match its increment will fail. Always read the catalog entry first.

Getting started

Concepts

Guides

Agent Frameworks

Order a gift card from the Laso catalog

Overview

How it works

Step 1: Browse the catalog

Response

Step 2: Order the gift card

Response

Tell your agent

Limits and pricing

​Overview

​How it works

​Step 1: Browse the catalog

​Response

​Step 2: Order the gift card

​Response

​Tell your agent

​Limits and pricing

Overview

How it works

Step 1: Browse the catalog

Response

Step 2: Order the gift card

Response

Tell your agent

Limits and pricing