# Paid Delivery Failure Remedy Procedure

> Paid Delivery Failure Remedy Procedure is a paid API for AI agents from k2so.grok.me, paid per call via x402, $0.002/call, status unknown (last checked 2026-09-14).

Provides a structured buyer-side decision procedure for recovering from failed paid x402 API calls, including evidence preservation, retry logic, refund claim filing, and vendor trust management.

## Facts

- Endpoint: GET https://k2so.grok.me/api/services/paid-delivery-failure-remedy-procedure
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/paid-delivery-failure-remedy-procedure-dd2a7145
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_GP8qgglIumPMlcxAnTXjx

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 paid-delivery-failure-remedy-procedure-dd2a7145
```

Example prompt: I just paid for an x402 API call but got a 503 error back with an empty body — walk me through the remedy procedure so I know whether to retry, file a refund claim, and whether to block that vendor from future auto-pay.

## When to prefer this

Use this endpoint whenever an AI agent has completed an x402 payment but received no usable response (5xx, timeout, empty body, malformed payload, or explicit error). Prefer this over ad-hoc retry logic to avoid the double-payment trap, ensure evidence is frozen at failure time, and get a structured refund claim pack. Especially critical for agents with auto-pay enabled on multiple vendors, where unmanaged failures can compound silently.

## Known failure modes

- Endpoint itself returns 5xx — procedure handles this as an input scenario, not a failure of the procedure
- Missing required payment transaction hash or quote digest in request — incomplete evidence prevents full remedy assessment
- Facilitator is unreachable for escalation verification — procedure surfaces this as a separate escalation path
- Fresh price probe on retry returns a changed quote — procedure may abort retry to avoid overpayment

## How this service works

Buyer-side remedy procedure for a paid x402 call that returned nothing usable: 5xx, timeout, empty body, malformed payload, or error response. Freeze evidence at failure time (payment tx hash, quote digest, request fingerprint, response status), classify transient vs terminal, retry at most once after a fresh price probe, open a refund claim with a complete evidence pack, escalate on facilitator silence, update merchant trust, and block auto-pay on flagged vendors. Prevents the classic agent failure: paying a dead endpoint twice while a refund claim sits open.

## Output

Returns a structured remedy decision payload indicating whether the failure is transient or terminal, whether a retry is recommended, a complete evidence pack for refund claim submission, facilitator escalation guidance, merchant trust score update, and auto-pay block recommendation for flagged vendors.

## 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": "Paid delivery failure remedy 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"
        },
        "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/paid-delivery-failure-remedy-procedure-dd2a7145/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from k2so.grok.me](https://www.zero.xyz/host/k2so.grok.me/llms.txt)