{"uid":"cap_-4vL53E-ABlTKrfRPKaqs","slug":"agent-post-settlement-failure-recovery-decision-procedure-cc3dd1fd","name":"Agent Post-Settlement Failure Recovery Decision Procedure","description":"Classify paid x402/MPP call failures after settlement as timeout, malformed response, silent drop, partial data, or wrong data. Decide between retry, refund request, or provider switch. Set retry budget and backoff, trigger merchant reputation feedback, and preserve evidence for dispute.","url":"https://k2so-8080.on.ascii.dev/api/services/agent-post-settlement-failure-recovery-decision","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 post-settlement failure recovery 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_KGKDN3_r5YOlO6U3AvlCx","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":"Classifies paid x402/MPP call failures after settlement and returns a structured decision on whether to retry, request a refund, or switch providers, along with retry budget, backoff settings, and dispute evidence preservation guidance.","exampleAgentPrompt":"I just made a paid x402 API call that settled successfully but the provider returned malformed data — can you classify this failure and tell me whether I should retry, request a refund, or switch providers, and what retry budget and backoff to use?","exampleUseCases":[{"title":"Silent drop after micropayment settlement","prompt":"My agent paid for an x402 service call and the payment went through, but the provider returned nothing at all — can you classify this as a silent drop and decide whether I should retry or file for a refund?"},{"title":"Wrong data returned post-payment triage","prompt":"After settling payment for an x402 data API, the response came back with completely wrong data — classify this failure and tell me the right recovery action, including whether I should flag the merchant's reputation."},{"title":"Retry budget for repeated timeouts","prompt":"My agent keeps hitting timeouts on a paid x402 endpoint even after settlement — give me a failure classification, a retry budget with backoff settings, and advice on whether to switch providers or preserve evidence for a dispute."}],"resultDescription":"A prose decision brief classifying the post-settlement failure type (timeout, malformed response, silent drop, partial data, or wrong data), a recommended recovery action (retry, refund request, or provider switch), retry budget and backoff parameters, a merchant reputation feedback trigger recommendation, and guidance on preserving dispute evidence. Includes metadata such as generation source (llm, reasoning, or deterministic) and ISO-8601 timestamp.","failureModes":["No payment sent or payment rejected — returns unpaid/402 response rather than decision content","Invalid or missing topic parameter may result in a generic procedure rather than a tailored one","LLM generation failure may return ok:false with empty brief","Rate limiting or service unavailability on the provider side returns an error response","Malformed query parameters cause schema validation failure"],"whenToPreferThis":"Use this endpoint when an AI agent has already settled payment for an x402 or MPP call and received a failure response, and needs a structured, actionable recovery decision rather than manual triage. Prefer this over generic retry logic when you need failure classification, backoff guidance, merchant reputation feedback, and dispute evidence handling in a single procedural call.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T07:00:00.545Z","isFirstParty":false}