# Agent Retail Checkout Purchase Authorization Procedure

> Agent Retail Checkout Purchase Authorization Procedure 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-13).

Deterministic gate that validates an agent's retail checkout purchase against intent, category allowlist, price limits, and delivery requirements before authorizing payment.

## Facts

- Endpoint: GET https://k2so-8080.on.ascii.dev/api/services/agent-retail-checkout-purchase-authorization-p
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agent-retail-checkout-purchase-authorization-procedure-ff006db4
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ZVxZ5m-iY2Bp0Rvp4c659

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-retail-checkout-purchase-authorization-procedure-ff006db4
```

Example prompt: Before you pay for this eSIM at the x402 checkout, run it through the retail purchase authorization gate — check that it matches my task intent, falls in an allowed category, and the price including fees is within 20% of my task budget.

## When to prefer this

Use this endpoint when an AI agent is about to complete a retail purchase at an x402 checkout and needs a deterministic, ordered pre-payment gate — especially for categories like gift cards, eSIMs, prepaid top-ups, table bookings, or physical pickup items where category compliance, price limits, and delivery verification are required before committing funds. Prefer this over generic budget checks when the x402 rail is in use and the principal has defined a category allowlist.

## Known failure modes

- Category not in allowlist — purchase blocked with flagged category reason
- Price exceeds 20% of task value plus fees — authorization denied with budget overage detail
- Checkout payload intent mismatch — procedure returns ok:false with mismatch explanation
- Regulated or non-refundable item detected — flagged and blocked before settlement
- Delivery verification not met — gate holds authorization pending delivery confirmation
- Malformed checkout payload — handler returns ok:false with parsing error

## How this service works

Deterministic gate for an agent authorized to buy goods or services at x402 retail checkouts (gift cards, eSIMs, prepaid top-ups, table bookings, physical pickup items). Ordered checks: verify what is actually being purchased by parsing the checkout payload and comparing against the task's purchase intent, category allowlist from the principal with non-refundable and regulated categories flagged, price against 20% of task value plus checkout fee and rail fee, delivery verification before

## Output

Returns a JSON object with an authorization decision (ok boolean), a decision procedure prose brief for agents, the service slug, generation source (llm/reasoning/deterministic), and an ISO-8601 timestamp. Includes payment metadata such as payer, transaction reference, and whether it was self-pay.

## 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 retail checkout purchase authorization 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)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agent-retail-checkout-purchase-authorization-procedure-ff006db4/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)