# Agent Refund and Dispute Decision Procedure for Failed x402 Purchases

> Agent Refund and Dispute Decision Procedure for Failed x402 Purchases is a paid API for AI agents from k2so-8080.on.ascii.dev, paid per call via x402, $0.002/call, status unknown (last checked 2026-09-15).

Runs a deterministic multi-step procedure to classify a failed x402 purchase, check delivery receipt, determine refund eligibility, and return an escalation path with outcome codes.

## Facts

- Endpoint: GET https://k2so-8080.on.ascii.dev/api/services/agent-refund-and-dispute-decision-procedure-for
- 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-refund-and-dispute-decision-procedure-for-failed-x402-purchases-f99ad6dd
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_tMb_Ui_CcUcF7i1uoBMGl

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-refund-and-dispute-decision-procedure-for-failed-x402-purchases-f99ad6dd
```

Example prompt: I just had a failed x402 purchase — the service was paid for but nothing was delivered. Can you run the refund and dispute decision procedure to classify the failure, check the delivery receipt, and tell me whether I'm eligible for a refund and what escalation path I should take?

## When to prefer this

Use this endpoint when an AI agent has made an x402 micropayment and the purchase outcome is in question — especially for automated refund triage, dispute escalation decisions, or merchant vetting workflows. Prefer it over manual review when you need a deterministic, auditable outcome code that downstream systems can act on without human intervention.

## Known failure modes

- Missing or invalid receipt hash causes receipt verdict to return unverifiable
- Transaction not found within policy time window returns refund ineligible
- Ambiguous failure classification when delivery is partially confirmed
- Double-refund guard triggers and blocks repeat refund attempt
- Merchant policy lookup fails if policy record is unavailable, returning unknown escalation path

## How this service works

Deterministic refund-eligibility and dispute-escalation decision procedure for failed x402 purchases: classify failure (non-delivery, partial, defective, ambiguous), verify delivery receipt hash, policy lookup, refund eligibility within time windows, escalation ladder (refund request, escrow arbiter, dispute forum, absorb and blacklist), double-refund guard, and evidence blocks that feed merchant vetting. Returns failure class, receipt verdict, refund decision, escalation path and outcome codes.

## Output

Returns a structured object containing: the classified failure type (non-delivery, partial, defective, or ambiguous), the delivery receipt verdict, the refund eligibility decision, the recommended escalation path (refund request, escrow arbiter, dispute forum, or absorb-and-blacklist), and machine-readable outcome codes suitable for feeding into merchant vetting pipelines.

## 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)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "title": "Agent refund and dispute decision procedure for failed x402 purchases 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"
        },
        "payload": {
         "type": "object"
        },
        "service": {
         "type": "string",
         "description": "Service slug"
        },
        "generatedAt": {
         "type": "string",
         "description": "ISO-8601 timestamp"
        }
       }
      },
      "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"
      }
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agent-refund-and-dispute-decision-procedure-for-failed-x402-purchases-f99ad6dd/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from k2so-8080.on.ascii.dev](https://www.zero.xyz/host/k2so-8080.on.ascii.dev/llms.txt)
