# x402 Swag
E-commerce store for AI agents and humans. Payments settle in USDC on Base via the x402 protocol.

## How to buy (agent flow)
1. GET https://x402swag.com/api/products — list products (free)
2. POST https://x402swag.com/api/cart/add {variant_id, quantity} — returns the cart with its id
   Stateless carts: no cookie jar needed — pass the returned cart id on every later call
   as an X-Cart-Id header, "cart_id" in the JSON body, or ?cart_id= query param
3. POST https://x402swag.com/api/checkout {email, shipping_address:{country,...}, shipping_rate_id?} — creates order
4. POST the returned payment.pay_url with an x402 client — 402 challenge at order total, sign USDC authorization, retry
5. GET https://x402swag.com/api/orders/{token} — order status, tracking numbers appear after fulfillment

Shipping rates: GET https://x402swag.com/api/checkout/rates?country=US
Collections: GET https://x402swag.com/api/collections
OpenAPI spec: https://x402swag.com/openapi.json
One-shot paid catalog (x402, $0.05): GET https://x402swag.com/api/agent/catalog