{"uid":"cap_ZVxZ5m-iY2Bp0Rvp4c659","slug":"agent-retail-checkout-purchase-authorization-procedure-ff006db4","name":"Agent Retail Checkout Purchase Authorization Procedure","description":"Deterministic gate for an agent authorized to buy goods or services at x402 retail checkouts (gift cards, eSIMs, prepaid top-ups, table bookings, physical pickup items). Ordered checks: verify what is actually being purchased by parsing the checkout payload and comparing against the task's purchase intent, category allowlist from the principal with non-refundable and regulated categories flagged, price against 20% of task value plus checkout fee and rail fee, delivery verification before","url":"https://k2so-8080.on.ascii.dev/api/services/agent-retail-checkout-purchase-authorization-p","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","properties":{"meta":{"enum":["0","1"],"type":"string","description":"Set to 1 for free metadata JSON (no payment required)"},"topic":{"type":"string","description":"Optional topic override for the decision procedure"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","title":"Agent retail checkout purchase authorization procedure paid response","$schema":"https://json-schema.org/draft/2020-12/schema","required":["ok","paid","service","provider","result"],"properties":{"ok":{"type":"boolean"},"paid":{"type":"boolean"},"result":{"type":"object","required":["ok","service"],"properties":{"ok":{"type":"boolean","description":"Handler success"},"brief":{"type":"string","description":"Decision procedure prose for agents"},"model":{"type":"string"},"topic":{"type":"string"},"service":{"type":"string","description":"Service slug"},"procedure":{"type":"string"},"generatedAt":{"type":"string","description":"ISO-8601 timestamp"},"generationSource":{"enum":["llm","reasoning","deterministic"],"type":"string"}}},"payment":{"type":"object","properties":{"code":{"type":"string"},"payer":{"type":"string"},"detail":{"type":"string"},"selfPay":{"type":"boolean"},"transaction":{"type":"string"}}},"service":{"type":"string"},"provider":{"type":"string","const":"K-2SO"}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_LtnK9uB9hudy03E29t3r5","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Deterministic gate that validates an agent's retail checkout purchase against intent, category allowlist, price limits, and delivery requirements before authorizing payment.","exampleAgentPrompt":"Before you pay for this eSIM at the x402 checkout, run it through the retail purchase authorization gate — check that it matches my task intent, falls in an allowed category, and the price including fees is within 20% of my task budget.","exampleUseCases":[{"title":"Gift card purchase budget gate","prompt":"I'm about to buy a $50 Amazon gift card at an x402 checkout — can you run the authorization check to make sure it's within my task budget, in an allowed category, and not a non-refundable item I shouldn't be buying?"},{"title":"eSIM regulated category check","prompt":"Before completing this eSIM purchase at the x402 retail checkout, verify it's allowed under my agent's category allowlist and that the total price with fees doesn't exceed 20% of my assigned task value."},{"title":"Prepaid top-up intent match verification","prompt":"I need you to check this prepaid mobile top-up checkout against my original purchase intent — make sure the item, price, and delivery conditions all clear the authorization procedure before you approve payment."}],"resultDescription":"Returns a JSON object with an authorization decision (ok boolean), a decision procedure prose brief for agents, the service slug, generation source (llm/reasoning/deterministic), and an ISO-8601 timestamp. Includes payment metadata such as payer, transaction reference, and whether it was self-pay.","failureModes":["Category not in allowlist — purchase blocked with flagged category reason","Price exceeds 20% of task value plus fees — authorization denied with budget overage detail","Checkout payload intent mismatch — procedure returns ok:false with mismatch explanation","Regulated or non-refundable item detected — flagged and blocked before settlement","Delivery verification not met — gate holds authorization pending delivery confirmation","Malformed checkout payload — handler returns ok:false with parsing error"],"whenToPreferThis":"Use this endpoint when an AI agent is about to complete a retail purchase at an x402 checkout and needs a deterministic, ordered pre-payment gate — especially for categories like gift cards, eSIMs, prepaid top-ups, table bookings, or physical pickup items where category compliance, price limits, and delivery verification are required before committing funds. Prefer this over generic budget checks when the x402 rail is in use and the principal has defined a category allowlist.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T19:02:14.533Z","isFirstParty":false}