# StableGift API

StableGift creates Loop & Tie gift redemption links paid with x402 or MPP. A buyer pays upfront and receives a redeem URL. The recipient opens the URL, chooses one item from the selected collection, and enters their own shipping address.

Supported payment paths: x402 on Base, x402 on Solana, and MPP on Tempo.

## Flow

1. GET /api/collections — list supported gift collections capped at $150.
2. POST /api/gift-link — pay via x402 and create a gift redemption link.
3. GET /api/gifts/{giftId} — check gift status and events.

## Collections

Collections are curated from Loop & Tie and capped at $150. Impact-only collections such as "$10 - Happy Planet", "$15 - Give Back", and Social Impact collections are hidden by default so agents get shippable gift collections unless they explicitly build a different flow later.

Use collectionId from /api/collections when creating a gift link. Prices are exact collection prices in USDC.

## Gift Links

POST /api/gift-link
Body:
{
  "collectionId": "4438",
  "recipientName": "Sam",
  "message": "Happy birthday!",
  "from": "Merit Systems"
}

The route validates the collection before returning a 402 price. The buyer pays the collection price, then StableGift creates the Loop & Tie gift with delivery_method "link" and returns giftId, redeemUrl, stage, expiresOn, and collection.

The recipient does not need a wallet and does not pay. They redeem the gift at redeemUrl.