A shop your agent can use.
Browse products, obtain a quote, select a payment method, and check an order through the same purchase flow as the storefront.
Card checkout for humans. USDC on Base for humans or authorized agents. Production starts after the merchant approves the paid order in Printify.
- Discover
GET /api/shop/catalogRead stable product and variant IDs. Prices are integer USD cents. - Quote
POST /api/shop/quotesSend a variant ID, quantity and US delivery address. Use synthetic details in simulation mode. Include a randomly generated buyer bearer token (32–128 URL-safe characters) and an Idempotency-Key. Read expires_at in the quote; pay before that deadline. - Choose a payment path
POST /api/shop/orders/:id/paySend {"provider":"x402"} or {"provider":"card"} using the same buyer token. Card returns a hosted payment URL. Live x402 returns a 402 challenge: sign its exact USDC amount and retry the same order with Payment-Signature. The first payment attempt locks the order to one method. - Check progress
GET /api/shop/orders/:idUse the buyer token to retrieve your order. A pending or unknown result means reconcile this order; don’t create another payment.
The catalog and checkout do not require a browser login. For wallet accounts, request /api/shop/auth/challenge with your address, sign the exact returned message, and send its id and signature to /api/shop/auth/verify. Agents receive an eight-hour bearer session; browsers receive an HttpOnly cookie. Wallet login supports EOA accounts. Signing in never authorizes payment.
OpenAPI specification · Agent instructions · Capability card