# Agent Post-Settlement Failure Recovery Decision Procedure

> Agent Post-Settlement Failure Recovery Decision Procedure is a paid API for AI agents from k2so.wrong.systems, paid per call via x402, $0.002/call, status unknown (last checked 2026-09-15).

Classifies paid x402/MPP call failures after settlement and prescribes a recovery action (retry, refund request, or provider switch) with retry budget, backoff strategy, reputation feedback, and dispute evidence preservation.

## Facts

- Endpoint: GET https://k2so.wrong.systems/api/services/agent-post-settlement-failure-recovery-decision
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agent-post-settlement-failure-recovery-decision-procedure-281f4109
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_O2HIyMYSixaNAKo-T8e2F

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability agent-post-settlement-failure-recovery-decision-procedure-281f4109
```

Example prompt: My agent just paid for an x402 call but got a malformed response after settlement — can you classify the failure type and tell me whether to retry, request a refund, or switch providers, including what retry budget and backoff to use?

## When to prefer this

Choose this endpoint when an AI agent has already completed x402/MPP payment settlement and needs a structured, opinionated recovery decision rather than generic error handling logic. It is specifically designed for the post-settlement failure window where the agent must quickly decide between retrying, escalating to a refund, or switching providers, and needs retry budgets, backoff parameters, and reputation feedback guidance in one call. Prefer it over generic error-handling libraries when operating in an autonomous agentic commerce context where financial accountability and dispute evidence are important.

## Known failure modes

- Missing or invalid 'type' or 'method' fields returns a schema validation error
- Ambiguous failure scenario may produce a non-actionable 'insufficient context' brief
- LLM generation failure falls back to deterministic or cached response
- Payment not settled causes 402 response before any decision is generated
- Rate limiting or quota exhaustion may return 429 with no result

## How this service works

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.

## Output

A structured decision brief containing: failure classification (timeout/malformed/silent drop/partial data/wrong data), recommended recovery action (retry/refund request/provider switch), retry budget and backoff parameters, a flag indicating whether merchant reputation feedback should be triggered, guidance on preserving dispute evidence, and a prose explanation of the decision procedure for the agent.

## Request schema (JSON Schema)

```json
{
 "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"
     
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "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-post-settlement-failure-recovery-decision",
   "procedure": "same as brief",
   "generatedAt": "2026-01-01T00:00:00.000Z",
   "generationSource": "deterministic"
  },
  "service": "agent-post-settlement-failure-recovery-decision",
  "provider": "K-2SO"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agent-post-settlement-failure-recovery-decision-procedure-281f4109/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from k2so.wrong.systems](https://www.zero.xyz/host/k2so.wrong.systems/llms.txt)