{"uid":"cap_Y9aYbFGuu3X-V8QeA4qVS","slug":"rye-x402-confirm-checkout-intent-1e88b883","name":"Rye x402 Confirm Checkout Intent","description":"Confirm a checkout intent. The first call returns 402 with an x402 payment challenge for the purchase total plus the Stripe crypto surcharge. Retry with the PAYMENT-SIGNATURE header to complete the confirmation.\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/confirm?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":null,"exampleRequest":null,"tags":[],"displayCostAmount":"unknown","displayCostAsset":"USD","priceDynamic":true,"priceHint":null,"priceStatus":"unknown_unparsed","priceSource":"registry","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":"unknown","summary":"price unknown","primary":{"kind":"dynamic","protocol":"x402","network":"base","amountUsd":null,"per":"call","confidence":"unknown"},"accepted":[{"kind":"dynamic","protocol":"x402","network":"base","amountUsd":null,"per":"call","confidence":"unknown"}]},"paymentMethods":[{"uid":"pm_E8i7be1ARK89c6GGcDrk8","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"unknown","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Finalizes a priced checkout intent to complete an e-commerce purchase via wallet-native x402 payment, covering the order total plus API and Stripe fees.","exampleAgentPrompt":"Go ahead and confirm my Rye checkout intent ci_abc123 — I've already reviewed the priced offer and I'm ready to finalize the purchase with my wallet.","exampleUseCases":null,"resultDescription":"Returns a JSON object with the checkout intent id and updated state (e.g. 'confirmed' or intermediate state). First call returns HTTP 402 with an x402 payment challenge encoding the order total plus $0.03 API fee and ~1.5% Stripe surcharge; the agent must sign and retry with a PAYMENT-SIGNATURE header to get the final confirmed response.","failureModes":["402 on first call — expected; agent must extract x402 challenge and retry with PAYMENT-SIGNATURE header","Invalid or missing PAYMENT-SIGNATURE header — payment rejected, intent not confirmed","Intent not in 'awaiting_confirmation' state — must poll GET /v1/checkout-intents?id={id} first","Wallet address mismatch — intent was scoped to a different buyer wallet","Intent expired or already confirmed — stale id returns error","Insufficient USDC balance to cover order total plus fees"],"whenToPreferThis":"Use this endpoint as step 3 of the Rye x402 three-step checkout flow, after creating an intent (POST /v1/checkout-intents) and polling until state='awaiting_confirmation' (GET /v1/checkout-intents). Choose this over generic payment APIs when your agent needs wallet-native USDC checkout across 15k+ merchants including Shopify, Amazon, and Best Buy, with x402 protocol payment gating.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-13T10:27:45.219Z","isFirstParty":false,"canonicalSlug":"rye-x402-confirm-checkout-intent-1e88b883"}