# Telco-Rail Settlement Dispute Playbook

> Telco-Rail Settlement Dispute Playbook is a paid API for AI agents from k2so.wrong.systems, paid per call via x402, $0.002/call, status down (last checked 2026-10-18).

Returns a deterministic step-by-step dispute procedure for agents handling billing disputes on telco/carrier rails (SMS billing, carrier billing, phone-bill settlement) where no on-chain receipt exists.

## Facts

- Endpoint: GET https://k2so.wrong.systems/api/services/agent-payment-dispute-handling-on-telco-carrier?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: down
- Last checked: 2026-10-18
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/telco-rail-settlement-dispute-playbook-e73e85d1
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_l2PZFVPFnR1Pl25Rxbpf3

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 telco-rail-settlement-dispute-playbook-e73e85d1
```

Example prompt: I was billed twice for the same service through carrier billing and there's no on-chain receipt — walk me through the step-by-step dispute procedure, including how to capture the carrier reference, detect the duplicate, file with the merchant first then the carrier, and make sure I don't re-pay until I have a refund receipt.

## When to prefer this

Choose this endpoint when an autonomous agent has made a payment over telco or carrier billing rails (SMS billing, phone-bill settlement) and needs a deterministic, step-by-step dispute procedure — especially when no on-chain receipt exists to verify the charge. Prefer this over generic payment dispute endpoints when the rail is specifically carrier/telco-based and the agent needs guidance on chargeback windows, merchant-vs-carrier escalation order, evidence retention, and the refund gate before re-attempting payment.

## Known failure modes

- Payment required but not provided — endpoint returns 402 before delivering the playbook
- Invalid or missing method parameter causes schema validation failure
- Topic override provided but unrecognized — procedure may default to generic telco dispute flow
- Service temporarily unavailable on k2so.wrong.systems — no procedure returned
- LLM or reasoning engine error — generationSource may indicate fallback or partial result

## How this service works

Deterministic dispute procedure for agents paying over telco or carrier billing rails (SMS billing, carrier billing, phone-bill settlement) where no on-chain receipt exists. Covers charge confirmation capture (carrier reference, merchant id, amount, timestamp), duplicate-charge and overcharge detection, merchant-then-carrier dispute filing inside the chargeback window, evidence tuple retention, and the refund-vs-double-pay gate: never re-pay disputed work until a refund receipt or a fresh

## Output

A structured decision procedure document (prose and/or structured steps) covering: charge confirmation capture (carrier reference, merchant ID, amount, timestamp), duplicate-charge and overcharge detection logic, merchant-first then carrier-second dispute filing sequence within the chargeback window, evidence tuple retention guidance, and a refund-vs-double-pay gate ensuring the agent never re-pays disputed work until a refund receipt or fresh authorization is confirmed. Response includes service slug, generation source, and ISO-8601 timestamp.

## 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": "Telco-rail settlement dispute playbook 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)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/telco-rail-settlement-dispute-playbook-e73e85d1/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)
