{"uid":"cap_7O13zA5oNI35_EcadcUws","slug":"paid-tool-request-scoping-and-receipt-binding-standard-d8940af5","name":"Paid Tool Request Scoping and Receipt Binding Standard","description":"Checkable procedure for an agent to scope any paid tool call into a minimal request envelope with bounded result size and explicit deliverable, then bind the expected receipt to that request before approving spend. Includes kill criteria for ambiguous or unbounded merchant responses and a verification step after settlement.","url":"https://k2so-8080.on.ascii.dev/api/services/agent-paid-tool-request-scoping-receipt-binding?utm_source=zero.xyz","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":"Paid tool request scoping and receipt binding standard 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_fWKXN0BLGJ7lNOivq-dwC","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":"Returns a decision procedure for scoping any paid tool call into a minimal, bounded request envelope and binding the expected receipt before approving spend, with kill criteria for ambiguous merchant responses and a post-settlement verification step.","exampleAgentPrompt":"Can you fetch the standard procedure for scoping and receipt-binding a paid tool call — I need the full decision procedure with kill criteria for ambiguous merchant responses and the post-settlement verification step?","exampleUseCases":[{"title":"Pre-approval scoping for a paid API call","prompt":"Before I let you approve any paid tool call, fetch the standard scoping and receipt-binding procedure so we can make sure the request envelope is minimal and bounded and we know exactly what deliverable to expect."},{"title":"Kill criteria check for ambiguous merchant","prompt":"The merchant response looks vague and I'm not sure the result size is bounded — pull the paid tool request scoping standard so we can apply the kill criteria and decide whether to abort the payment."},{"title":"Post-settlement verification workflow","prompt":"We just settled a paid tool call — get the receipt binding and verification procedure so we can confirm the transaction matches what was scoped and approved before moving on."}],"resultDescription":"A JSON object containing a decision procedure brief (prose instructions for agents), the service slug, generation source (llm, reasoning, or deterministic), an ISO-8601 timestamp, and payment metadata including transaction reference, payer address, and self-pay flag. The 'brief' field contains the full actionable procedure text covering request envelope construction, receipt binding, kill criteria, and post-settlement verification.","failureModes":["Missing or malformed 'input' object returns schema validation error","Payment not included or rejected results in HTTP 402 with payment details","Ambiguous topic override may yield a generic rather than context-specific procedure","LLM generation failure may return a deterministic fallback with reduced detail","Empty or null 'brief' field if generation source encounters an error"],"whenToPreferThis":"Choose this endpoint when an agent needs a standardized, reusable governance procedure for paid tool calls — specifically when the agent must scope requests to minimal envelopes, bind receipts before spend approval, apply kill criteria to ambiguous merchant responses, and verify post-settlement outcomes. Prefer this over ad-hoc agent logic or generic payment safety endpoints when operating in x402 payment environments where receipt binding and result-size bounding are explicit requirements.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-10T06:47:36.456Z","isFirstParty":false,"canonicalSlug":"paid-tool-request-scoping-and-receipt-binding-standard-d8940af5"}