# UOS Genesis Payment Doctor

> UOS Genesis Payment Doctor is a paid API for AI agents from genesis.palsus2023.workers.dev, paid per call via x402, $0.003/call, status unknown (last checked 2026-10-12).

Diagnoses x402 and machine-payment failures, returning the likely cause, retryability status, and recommended repair action.

## Facts

- Endpoint: POST https://genesis.palsus2023.workers.dev/v1/payment_doctor?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/uos-genesis-payment-doctor-9c5315c0
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_irO7rCg-2FZjsdWj-KDlS

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 uos-genesis-payment-doctor-9c5315c0 -d '<json body>'
```

Example prompt: I'm getting a payment failure in my x402 agent pipeline — can you run it through the payment doctor and tell me what went wrong, whether I should retry it, and how to fix it? Here's the error: 'Payment rejected: insufficient allowance on Base USDC contract'.

## When to prefer this

Choose this endpoint when an AI agent or automation pipeline encounters x402 or Base USDC payment errors and needs structured, programmatic guidance on root cause, retryability, and remediation — especially within autonomous agent workflows where human intervention is not available. It is purpose-built for the x402 protocol ecosystem, making it more specific and actionable than generic error-lookup tools.

## Known failure modes

- Missing or malformed 'input' string in the request body returns an error response
- Payment for the API call itself fails via x402, blocking execution
- Ambiguous or too-short error description may yield a low-confidence diagnosis
- Network timeout on the Cloudflare Worker edge node
- Unrecognized x402 error codes may return a generic or inconclusive result

## How this service works

Autonomous paid machine utilities using x402 and Base USDC.

## Output

A JSON object with 'success' (boolean), 'service' ('payment_doctor'), and 'result' (a machine-readable string describing the diagnosed failure cause, whether the payment can be retried, and the recommended repair action).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "type": "object",
     "properties": {
      "input": {
       "type": "string",
       "description": "Diagnoses x402 and machine-payment failures and returns likely cause, retryability and repair action."
      }
     },
     "additionalProperties": true
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object"
  }
 },
 "additionalProperties": true
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "result": "GENESIS* machine-readable service result",
  "service": "payment_doctor",
  "success": true
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/uos-genesis-payment-doctor-9c5315c0/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from genesis.palsus2023.workers.dev](https://www.zero.xyz/host/genesis.palsus2023.workers.dev/llms.txt)