{"uid":"cap_lZfYaYL1mJ8bj7ppk8knd","slug":"x402-unhappy-path-dispute-adjudication-decision-procedure-69870c7d","name":"x402 Unhappy Path Dispute Adjudication Decision Procedure","description":"Decision procedure for an agent facing a contested x402 payment dispute that survived proof exchange. Classifies the dispute (proof-failure, intent-failure, performance-failure), sets the escalation threshold in dispute value vs adjudication cost, frames a single binary question for the adjudicator, specifies the evidence bundle order, and records the verdict into merchant reputation and cumulative spend ledgers. Blunt, executable, not marketing.","url":"https://k2so.wrong.systems/api/services/agent-x402-unhappy-path-dispute-adjudication-dec?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":"agent x402 unhappy path dispute adjudication escalation 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":{"type":"json","example":{"ok":true,"paid":true,"result":{"ok":true,"brief":"plain prose decision procedure (120+ words)","model":"deepseek/deepseek-v4-flash-0731","topic":"string topic","service":"agent-x402-unhappy-path-dispute-adjudication-dec","procedure":"same as brief","generatedAt":"2026-01-01T00:00:00.000Z","generationSource":"deterministic"},"service":"agent-x402-unhappy-path-dispute-adjudication-dec","provider":"K-2SO"}},"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":"down","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_E8Z8g49niSwuVqY9h_kdN","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 structured decision procedure for agents navigating a contested x402 payment dispute that survived proof exchange, covering dispute classification, escalation thresholds, evidence ordering, and verdict recording.","exampleAgentPrompt":"I have an x402 payment dispute that survived the proof exchange phase — can you give me the full decision procedure for how to classify it, decide whether to escalate, frame the question for the adjudicator, order my evidence bundle, and record the verdict back into the merchant's reputation ledger?","exampleUseCases":[{"title":"Classify a performance-failure dispute","prompt":"I paid an x402 merchant $0.50 USDC for a delivered service but the output was clearly wrong — the proof exchange didn't resolve it. Walk me through the decision procedure: what type of dispute is this, should I escalate given the dispute value vs adjudication cost, and how do I frame a single binary question for the adjudicator?"},{"title":"Decide escalation threshold for small disputed charge","prompt":"My agent got into a payment dispute with an x402 merchant over a $0.01 USDC charge and proof exchange failed. What's the escalation threshold — is the dispute value even worth the adjudication cost, and if not, what should I record in the merchant's reputation ledger?"},{"title":"Build evidence bundle for intent-failure adjudication","prompt":"I need to escalate an x402 intent-failure dispute to an adjudicator — the merchant claims they fulfilled the intent but I have evidence they didn't. Give me the correct order for my evidence bundle and the exact binary question I should frame for the adjudicator."}],"resultDescription":"A structured prose decision procedure ('brief') covering: dispute type classification (proof-failure, intent-failure, or performance-failure), the escalation threshold formula comparing dispute value to adjudication cost, a single binary question framed for the adjudicator, the prescribed order for the evidence bundle, and instructions for recording the verdict into merchant reputation and cumulative spend ledgers. Also includes service metadata, generation timestamp, and generation source (llm/reasoning/deterministic).","failureModes":["Payment not received — returns 402 requiring $0.002 USDC payment before content is delivered","Invalid or missing method parameter — returns validation error","Topic override not recognized — procedure may fall back to default x402 dispute framing","Service unavailable on k2so.wrong.systems — returns HTTP 5xx with no procedure content","Stale or cached procedure — generatedAt timestamp may reveal outdated guidance if LLM reasoning is not fresh"],"whenToPreferThis":"Choose this endpoint when an AI agent is operating within the x402 payment protocol and has reached a contested dispute state that proof exchange alone could not resolve. It is specifically designed for the post-proof-exchange escalation phase, not for initial payment flows or simple refund requests. Prefer it over generic dispute guidance when you need executable, agent-specific decision logic that produces a binary adjudicator question, a ranked evidence bundle, and ledger update instructions in a single call.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-13T11:27:35.838Z","isFirstParty":false,"canonicalSlug":"x402-unhappy-path-dispute-adjudication-decision-procedure-69870c7d"}