API Pay

info

Active portfolio classification — 2026-07-25 [D]. API Pay is a pre-launch payment-and-receipt capability composed inside Skyzai Work, with Personal composition only where the owning surface declares it. It is not an independent SKU or package. Any “wedge product,” independently sellable, pricing, commercial-page, or launch language below is preserved design history; linked routes are compatibility coordinates, not deployment proof.

note

Current public-DAV authority boundary — 2026-07-12. Pre-launch target design; nothing here proves a live system. A public-DAV consequence may occur only when at least two natural-person councilors bind the exact consequence in a complete valid bound PRISM decision receipt. PRISM records and verifies that receipt only; it never serves as council, signatory, authority, or receipt producer. AI and caste seats stage unsigned proposals only; they never authorize or execute a public-DAV consequence. Constitution or membership adoption establishes constitution and membership only; it does not authorize a later consequence. Policy may constrain an unsigned proposal but never authorizes execution or substitutes for the complete consequence-bound receipt. Before receipt validity, consequence fails closed to read-only proposal, simulation, or deterministic sandbox; live evidence remains gated_pending_complete_valid_bound_receipt. Software deterministically carries out only the exact consequence bound to a complete valid bound PRISM decision receipt from at least two natural-person councilors binding that exact consequence.

Scope: capability inside the two buyer products (Skyzai Personal / Skyzai Work ✱) — not a standalone SKU. See The Product Family.

Surface: api-pay.skyzai.com (declarative) Docs: skyzai.org/docs/api-pay (normative) Status: LOCAL_PROOF · Phase 1 Evidence tier: [B] — local executable proof exists (its own loop only); [E] requires independent measurement plus the applicable typed authority and receipt Canonical manifest: 02_SKYZAI/02_ORGANISM_COMMONS/NOOSPHERE/03_PRODUCTS/00_SKYZAI_COM_PRODUCT_MANIFEST.md

---

What API Pay Is

API Pay is a wedge product — the first independently sellable service on skyzai.com. It wraps a single premium API endpoint with:

1. Quote — returns the price for the paid action
2. 402 Gate — rejects with 402 Payment Required if entitlement insufficient
3. DLT Settlement — verifies payment on-chain
4. OFN Receipt — emits a machine-readable receipt packet
5. Finance Export — exports bundled receipts to finance/controls stack

The service is independently usable — a buyer does not need to adopt the whole Skyzai organism.

---

Architecture

┌─────────────┐     ┌─────────────┐     ┌─────────────┐     ┌─────────────┐
│   Client    │────▶│  API Pay    │───▶│  EvoNet     │────▶│ Typed Auth  │
│   Request   │     │   Quote     │     │  SHOULD NOT │     │ Receipt Gate│
└─────────────┘     └─────────────┘     └─────────────┘     │   value)    │
       │                     │                     │         └─────────────┘
       │                     ▼                     ▼                │
       │              ┌─────────────┐     ┌─────────────┐          │
       │              │   402 or    │     │   DLT       │◀─────────┘
       │              │   Proceed   │     │  Settlement │
       │              └─────────────┘     └─────────────┘
       │                     │                     │
       │                     ▼                     ▼
       │              ┌─────────────┐     ┌─────────────┐
       └─────────────▶│ OFN Receipt │     │   Finance   │
                      │   Emission  │     │   Export    │
                      └─────────────┘     └─────────────┘

---

API Specification

POST /v1/quote

Returns a quote for the paid action.

Request:

{
  "endpoint": "swap",
  "params": {
    "from": "USDC",
    "to": "ETH",
    "amount": "100.00"
  },
  "buyer_id": "org_abc123"
}

Response:

{
  "quote_id": "qt_20260509_001",
  "price": {
    "amount": "0.5",
    "currency": "USDC",
    " Breakdown": {
      "service_fee": "0.02",
      "gas_estimate": "0.48"
    }
  },
  "expires_at": "2026-05-09T12:05:00Z",
  "status": "valid"
}

POST /v1/pay

Executes the paid action after entitlement check.

Request:

{
  "quote_id": "qt_20260509_001",
  "buyer_id": "org_abc123",
  "payment_tx": "0xabc...",
  "authorization_receipt": "receipt:..."
}

Response (success):

{
  "receipt_id": "ofn:2026:abc123...",
  "status": "settled",
  "tx_hash": "0xabc...",
  "timestamp": "2026-05-09T12:00:00Z"
}

Response (insufficient entitlement):

402 Payment Required
{
  "error": "INSUFFICIENT_ENTITLEMENT",
  "message": "Buyer entitlement insufficient for this action.",
  "upgrade_url": "https://skyzai.com/products/api-pay"
}

---

Evidence Tiers

Ladder per 14-evidence-tiers.md ([C] < [D] < [S] < [B] < [E]):

Tier	Claim	Required Evidence
[D]	API Pay can wrap one endpoint	Design document, API spec
[B]	API Pay emits OFN receipt for local test	Dated local integration run, reproducible steps
[E]	External customer paid for API Pay service	Independent settlement proof, typed external authority, and live-environment measurement

Current status: [B] — local proof exists for its own loop; external pilot pending. A local run never promotes the system.

---

Integration Guide

Quick Start (Python)

from skyzai import APIPayClient

client = APIPayClient(api_key="your_key")

# Get quote
quote = client.quote(endpoint="swap", params={"from": "USDC", "to": "ETH", "amount": "100"})

# Execute (requires typed authority; a public DAV uses a valid PRISM receipt)
receipt = client.pay(
    quote_id=quote.id,
    payment_tx="0x...",
    authorization_receipt="receipt:..."
)

print(receipt.id)  # ofn:2026:...

Webhook

Configure webhooks for settlement events:

client.webhooks.create(
    url="https://your-domain.com/webhooks/skyzai",
    events=["settlement.confirmed", "settlement.failed", "receipt.emitted"]
)

---

Security

• Typed authority: High-value acts require the lawful executor and authorization receipt appropriate to the acting Person; every exact public-DAV consequence requires a complete valid bound PRISM decision receipt from at least two natural-person councilors binding that exact consequence; PRISM verifies only
• EvoNet Gate: All acts pass SHOULD NOT checks (jurisdiction, anomaly, policy)
• Replay Protection: Nonce-based replay protection on all payment transactions
• Timelock: 24-hour timelock on settlement execution (configurable per contract)

---

η = 0 Compliance

Chargeable	Not Chargeable
Software development	Settlement access
Integration services	DLT rail usage
Dashboards and analytics	Chain gas fees (pass-through)
Support and SLA	Sovereignty or exit

---

Cross-links

• Product page: /products/api-pay/
• Buyer deck: /products/api-pay/deck/
• Resource room: /products/api-pay/resources/
• Access form: /products/api-pay/access/
• Adjacent canon: OFN Receipts (P1), Wallet Boundaries (P3)
• Source markdown: 02_SKYZAI/02_ORGANISM_COMMONS/NOOSPHERE/03_PRODUCTS/api_pay_receipt_native_finops/WEBSITE.md

Refer to the canonical WEBSITE.md source for complete product spec. This wiki page exists so the .com → .org bidirectional pair resolves cleanly.

---

See Also

• API Pay — Commercial page
• OFN Receipts — Technical docs
• Wallet Boundaries — Technical docs
• 02_SKYZAI/01_LEVELS/L1_EVOLUTIONARY_NETWORK/01_ORGAN/runtime/gate_service.py
• 02_SKYZAI/02_ORGANISM_COMMONS/EXECUTION/SKYZAI/execution/contracts/FlowWalletV2.sol

---

Zero-Sum Resolution Equation

K3 public-DAV authority history — 2026-07-12

K3 historical reference — not active authority

note

Current public-DAV boundary — 2026-07-10. Pre-launch target design; nothing here is live. The active DAV is public and targets PRISM, with no K2 runtime, launch, genesis/bootstrap, or fallback dependency. Consequential authority requires at least two natural-person councilors; AI/caste seats stage unsigned proposals only. Before quorum, behavior fails closed to read-only/proposal, simulation, or deterministic sandbox, and a live decision receipt remains gated pending quorum.

• Typed authority: High-value acts require the lawful executor and authorization receipt appropriate to the acting Person; public-DAV discretion requires ≥2-natural-person PRISM quorum
• EvoNet Gate: All acts pass SHOULD NOT checks (jurisdiction, anomaly, policy)
• Replay Protection: Nonce-based replay protection on all payment transactions
• Timelock: 24-hour timelock on settlement execution (configurable per contract)