{"name":"BuyWith402","status":"paused","notice":"The service is currently paused: every endpoint below returns 403 and no payments are accepted or settled. The API described here will return when the service resumes.","description":"Buy real physical products (currently McMaster-Carr hardware) with one x402 USDC payment on Base. No account needed — the payment is the identity. All prices are all-inclusive: US shipping and tax are included.","payment":{"protocol":"x402","x402_version":2,"scheme":"exact","network":"eip155:8453","currency":"USDC"},"endpoints":[{"method":"GET","path":"/","description":"This guide."},{"method":"GET","path":"/health","description":"Service status."},{"method":"GET","path":"/products","description":"List all products (free). Optional ?query=<text> filters by case-insensitive substring across id, name, description, and merchant (e.g. ?query=cookie)."},{"method":"GET","path":"/products/{id}","description":"One product (free)."},{"method":"POST","path":"/products/{id}/purchase","description":"Buy a product. Returns a 402 x402 challenge; retry with payment to receive an order_id. Body: { quantity?, email?, shipping: { name, address_1, address_2?, city, state, zip, country? }, gift_note?, dry_run? }. email is optional and used for order records only — it is NOT entered at the merchant; omit it unless you want it on file."},{"method":"GET","path":"/orders/{order_id}","description":"Order status + live fulfillment progress events (free). Poll with ?since=<next_since> for incremental updates, including screenshots of the agent checking out on the underlying merchant. Keep polling while final=false (statuses: queued, running, retrying — transient attempt failures retry automatically). When final=true, outcome is \"success\" (status ready_to_place or placed) or \"failure\" (status failed, only after all retries are exhausted)."},{"method":"POST","path":"/merchants","description":"Merchant Factory: onboard any store URL as agent-buyable products. Paid endpoint ($5.00 x402 charge — you are funding the browser-agent run). A browser agent extracts a validated catalog, estimates tax/fulfillment economics, and its products go live in GET /products within minutes. Body: { url, nickname?, display_name?, max_products? }. The response includes a poll URL — same live-events contract as orders."}],"pricing":"Prices are all-inclusive and itemized per product: merchant item price + our service fee (10% + $0.25, service_fee_usd) + estimated tax + fulfillment cost.","dry_run":"Purchases are REAL by default: fulfillment places the merchant order and the product ships to your address. Send dry_run=true for a rehearsal that stops at the merchant order-review screen without placing the order.","how_to_buy":["GET /products (?query=<text> to search) and pick a product id","Nothing suitable? POST /merchants with any store URL ($5.00 x402) — a browser agent onboards its catalog in minutes, then buy from it","POST /products/{id}/purchase with your shipping address — receive a 402 challenge","Pay the challenge with any x402 client (exact scheme, USDC on Base)","Poll GET /orders/{order_id} to watch fulfillment live"]}