{"uid":"cap_jmA91RvBh18VYJ0xkmGaW","slug":"rye-checkout-intent-creator-x402-6b505d54","name":"Rye Checkout Intent Creator (x402)","description":"Create a checkout intent. The first call returns 402 with an x402 payment challenge. After signing the authorization, retry with the PAYMENT-SIGNATURE header to complete the request.\n\nThis is step 1 of 3 for purchasing a product:\n(1) POST /v1/checkout-intents with productUrl → returns intent id ($0.02 USDC).\n(2) GET /v1/checkout-intents?id={id} (free, wallet-scoped — requires X-Wallet-Address matching the buyer wallet) → poll until state=\"awaiting_confirmation\" and review priced offer.\n(3) POST /v1/checkout-intents/confirm → finalize purchase (dynamic cost = order total + $0.03 API fee + ~1.5% Stripe surcharge).\nWallet-native checkout for 15k+ merchants — Shopify, Amazon, Best Buy, and others.","url":"https://x402.rye.com/v1/checkout-intents?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":null,"responseSchema":{"type":"object","required":["id","state"],"properties":{"id":{"type":"string","example":"ci_abc123"},"state":{"type":"string","example":"retrieving_offer"}},"additionalProperties":{}},"example":{"request":{"buyer":{"city":"San Francisco","email":"zero-qa@agentmail.to","phone":"+15555555555","country":"US","address1":"123 Main St","lastName":"QA","province":"CA","firstName":"Zero","postalCode":"94105"},"quantity":1,"productUrl":"https://www.amazon.com/dp/B08N5WRWNW","paymentMethod":{"type":"x402","network":"base"},"walletAddress":"0x742d35Cc6634C0532925a3b844Bc9e7595f42bE","notificationEmail":"zero-qa@agentmail.to"},"response":{"id":"ci_03335615c269416d9b113ce27a57d2ce","buyer":{"city":"San Francisco","email":"zero-qa@agentmail.to","phone":"+15555555555","country":"US","address1":"123 Main St","lastName":"QA","province":"CA","firstName":"Zero","postalCode":"94105"},"state":"retrieving_offer","quantity":1,"createdAt":"2026-05-29T23:01:55.994Z","productUrl":"https://www.amazon.com/dp/B08N5WRWNW"}},"exampleRequest":{"buyer":{"city":"San Francisco","email":"zero-qa@agentmail.to","phone":"+15555555555","country":"US","address1":"123 Main St","lastName":"QA","province":"CA","firstName":"Zero","postalCode":"94105"},"quantity":1,"productUrl":"https://www.amazon.com/dp/B08N5WRWNW","paymentMethod":{"type":"x402","network":"base"},"walletAddress":"0x742d35Cc6634C0532925a3b844Bc9e7595f42bE","notificationEmail":"zero-qa@agentmail.to"},"tags":[],"displayCostAmount":"0.02","displayCostAsset":"USD","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"down","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Lxzn5GZ6_SCvtPu7qvUos","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Initiates a wallet-native checkout intent for purchasing products from 15k+ merchants, returning an intent ID after satisfying a $0.02 USDC x402 payment challenge.","exampleAgentPrompt":"I want to buy this product — https://www.amazon.com/dp/B08N5WRWNW — using my crypto wallet. Can you start a checkout intent for me using my wallet address 0xAbc123...?","exampleUseCases":null,"resultDescription":"Returns a JSON object with a checkout intent ID (e.g. 'ci_abc123') and an initial state string (e.g. 'retrieving_offer'). This ID is used in subsequent polling (GET /v1/checkout-intents?id={id}) and confirmation (POST /v1/checkout-intents/confirm) steps to complete the purchase.","failureModes":["402 Payment Required on first call — expected; must sign the x402 authorization and retry with PAYMENT-SIGNATURE header","Invalid or missing product URL — returns 400 or error state","Invalid wallet address or missing wallet header — authentication failure","x402 payment signature invalid or expired — retry with fresh signature","Merchant not supported in Rye network — offer retrieval may fail downstream"],"whenToPreferThis":"Use this endpoint when you need to purchase a physical or digital product from a major retailer (Shopify, Amazon, Best Buy, etc.) using a crypto wallet and USDC, specifically via the x402 micropayment protocol. It is the entry point for Rye's 3-step wallet-native checkout flow and is ideal for AI agents automating purchases on behalf of users with Web3 wallets.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-13T14:26:35.718Z","isFirstParty":false,"canonicalSlug":"rye-checkout-intent-creator-x402-6b505d54"}