x402 Payment (geplant)

Noch nicht aktiv

Die x402-Authentifizierung ist in Entwicklung und gibt aktuell 503 Service Unavailable zurück. Geplanter Start: Q4 2026.

Was ist x402?

Das x402-Protokoll ermöglicht HTTP-native Micropayments. Anstatt eines API-Keys bezahlt der Aufrufer pro Request direkt on-chain. Ideal für autonome AI-Agents, die keinen Account oder Vertrag benötigen.

Ablauf (Challenge-Response)

1. Agent → POST /api/v1/agent/v1/stamp
   (ohne Payment-Header)

2. Server → 402 Payment Required
   {
     "x402Version": 1,
     "accepts": [
       {
         "scheme": "exact",
         "network": "base",
         "maxAmountRequired": "500000",
         "resource": "https://siegel.kavra.cloud/api/v1/agent/v1/stamp",
         "payTo": "0x1234...abcd",
         "token": "0x60a3E35Cc302bFA44Cb288Bc5a4F316Fdb1adb42",
         "currency": "EURC"
       },
       {
         "scheme": "exact",
         "network": "base",
         "maxAmountRequired": "550000",
         "resource": "https://siegel.kavra.cloud/api/v1/agent/v1/stamp",
         "payTo": "0x1234...abcd",
         "token": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
         "currency": "USDC"
       }
     ]
   }

3. Agent → EURC- oder USDC-Transfer auf Base Chain

4. Agent → POST /api/v1/agent/v1/stamp
   X-Payment-Transaction: 0xabc123...def
   (mit Request-Body wie bisher)

5. Server → 201 Created
   (verifiziert On-Chain-Zahlung, erstellt Stempel)

Preise pro Stempel

Tier	EUR-Listpreis	EURC (primary)	USDC (alt)
Basic	0,50 €	0,50 EURC	0,55 USDC
Plus	1,50 €	1,50 EURC	1,65 USDC
Sealed	3,00 €	3,00 EURC	3,30 USDC

Alle Preise netto. Zahlung auf Base (Coinbase L2). EURC ist die bevorzugte Währung (1:1 zum EUR-Listpreis). USDC bleibt als Fallback unterstützt und enthält einen FX-Risiko-Aufschlag.

Warum Base Chain?

Niedrige Transaktionskosten (< $0.01 pro Transfer)
EURC und USDC nativ verfügbar (Circle, beide MiCA-konform)
Breite Wallet-Unterstützung (Coinbase, MetaMask, etc.)
Schnelle Finality (~2 Sekunden)

Wallet-Adresse

Die Empfangs-Wallet wird im 402-Response als payTo-Feld mitgeteilt. Die Adresse kann sich ändern (z.B. bei Key-Rotation). Immer die Adresse aus dem aktuellen 402-Response verwenden.

Aktueller Status

Komponente	Status
x402-Challenge-Response	Implementiert (gibt 503)
On-Chain-Verifikation	In Entwicklung
Wallet-Custody (Turnkey)	In Evaluation
Treasury (Gnosis Safe)	Geplant

Vorbereitung

Wenn Sie x402 nutzen möchten, sobald es verfügbar ist:

Base-kompatible Wallet einrichten (z.B. Coinbase Wallet)
EURC oder USDC auf Base Chain bereithalten (EURC bevorzugt)
Ihren Agent für 402-Responses vorbereiten
Unseren Changelog beobachten

Frühzugang

Melden Sie sich unter office@kavra.cloud, um in die Beta-Liste für x402 aufgenommen zu werden.