x402 für TYPO3: Wie Ihre Website AI-Agents zur Kasse bittet

Auf einen Blick  

• x402 ist ein offenes Zahlungsprotokoll, das den HTTP-Statuscode 402 ("Payment Required") nutzt, um Pay-per-Request-Zahlungen direkt in HTTP einzubetten. Coinbase hat den Standard früh initiiert, die aktuelle Doku positioniert ihn aber ausdrücklich als offenes, neutral dokumentiertes Protokoll.
• Primärer Anwendungsfall: AI-Agents bezahlen automatisch für Content-Zugriff — keine Accounts, keine API-Keys, keine Checkout-Seiten.
• Die offiziellen x402-Dokumente decken inzwischen Seller-Quickstarts, MCP-Integration, Testnet-Setups und produktive Facilitators ab; das Ökosystem wächst sichtbar.
• Unsere neue TYPO3-Extension typo3-x402-paywall implementiert das Protokoll als PSR-15-Middleware — für Headless-APIs und klassische TYPO3-Frontends.
• Inklusive Capabilities.yaml — die Extension praktiziert, was wir im ersten Teil dieser Serie vorgestellt haben.

Inhaltsverzeichnis  

Das Geschäftsmodell des Webs steht unter Druck. Werbefinanzierte Inhalte funktionieren, solange ein Mensch die Seite besucht und Anzeigen sieht. Aber was passiert, wenn der "Besucher" ein AI-Agent ist, der im Auftrag einer Nutzerin Content abruft? Der Agent sieht keine Werbung. Er klickt keine Affiliate-Links. Er kauft kein Abo.

Publisher:innen benötigen neue Wege, um für ihre Inhalte vergütet zu werden. Genau dieses Problem adressiert x402.

Was ist x402?  

x402 nutzt den seit 1997 reservierten, aber nie breit genutzten HTTP-Statuscode 402 Payment Required. Das Prinzip: Ein Client fordert eine Ressource an. Erfordert diese eine Bezahlung, antwortet der Server mit 402 und den Zahlungsbedingungen. Der Client leistet die Zahlung und wiederholt die Anfrage — diesmal mit Zahlungsnachweis.

Warum jetzt?  

Drei Entwicklungen machen x402 gerade relevant:

1. AI-Agents werden zu Content-Konsumenten  

Claude, GPT, Gemini und spezialisierte Agents greifen zunehmend auf Web-APIs zu, um Informationen für ihre Nutzer:innen abzurufen. Jeder dieser Zugriffe hat einen Wert — aber es gibt bisher keinen standardisierten Weg, dafür zu bezahlen.

2. Stablecoins ermöglichen Micropayments  

Zahlungen von $0.001 pro Request waren mit klassischen Zahlungsmitteln wie Kreditkarten nie wirtschaftlich — die Transaktionsgebühren überstiegen den Zahlungsbetrag. Mit Stablecoins wie USDC auf schnelleren Netzwerken und passenden Facilitators werden Micropayment-Flows praktikabel, auch wenn Netzwerk- und Settlement-Kosten je nach Chain variieren.

3. Das Ecosystem wächst  

Unsere TYPO3-Extension: typo3-x402-paywall  

Die Extension webconsulting/typo3-x402-paywall implementiert x402 als PSR-15-Middleware mit zwei Modi:

# config/sites/main/config.yaml
x402_paywall:
  enabled: true
  wallet_address: "0xYOUR_WALLET_ADDRESS"
  network: "base-sepolia"
  default_price: "0.01"
  currency: "USDC"
  gated_route_patterns:
    - "/api/v1/content/*"
    - "/api/v1/articles/*"
  free_routes:
    - "/api/v1/health"
    - "/api/v1/navigation"

{
  "status": 402,
  "message": "Payment Required",
  "x402": {
    "version": "2",
    "requirements": [{
      "scheme": "exact",
      "network": "eip155:84532",
      "maxAmountRequired": "10000",
      "payTo": "0xYOUR_WALLET",
      "asset": {
        "address": "0x036CbD53842c...",
        "symbol": "USDC",
        "decimals": 6
      }
    }]
  },
  "human_readable": {
    "price": "0.01 USDC",
    "description": "Artikel: KI am Arbeitsmarkt"
  }
}

Architektur  

Interaktive Demo: x402 in Aktion  

Erleben Sie den x402-Zahlungsablauf Schritt für Schritt — von der ersten Anfrage bis zur Antwort:

Anfrage erscheint nach Start...

Antwort erscheint nach Simulation...

PSR-14 Events: Eigene Logik anbinden  

Die Extension dispatcht zwei Events, an die Sie eigene Listener hängen können:

use Webconsulting\X402Paywall\Event\PaymentRequiredEvent;
use TYPO3\CMS\Core\Attribute\AsEventListener;

#[AsEventListener]
final class PaywallAnalyticsListener
{
    public function __invoke(PaymentRequiredEvent $event): void
    {
        // Log: welche Inhalte werden angefragt?
        $this->logger->info('Paywall hit', [
            'uri' => $event->requestUri,
            'price' => $event->price,
        ]);
    }
}

Capability Manifest: Transparenz durch Deklaration  

Die Extension enthält ein eigenes Configuration/Capabilities.yaml und setzt damit das Konzept um, das wir im ersten Teil dieser Serie vorgestellt haben:

capabilities:
  version: "1.0"
  subsystems:
    - database:read
    - database:schema
    - site:middleware
    - tca:override
  network:
    outbound:
      - host: "x402.org"
        purpose: "x402 facilitator — payment verification and settlement"
        protocol: "https"
  events:
    dispatches:
      - Webconsulting\X402Paywall\Event\PaymentRequiredEvent
      - Webconsulting\X402Paywall\Event\PaymentReceivedEvent
  risk:
    level: "medium"
    justification: "Middleware, outbound network to facilitator"

Ein:e Administrator:in sieht sofort: Diese Extension fängt Requests ab (Middleware), liest die Pages-Tabelle, und kommuniziert mit genau einem externen Host (dem x402-Facilitator). Kein Wildcard-Netzwerkzugriff, kein XCLASS.

Für wen ist das relevant?  

Aktuelle Einschränkungen und Ausblick  

Was heute schon funktioniert:

• Testnet-Modus (Base Sepolia) für Entwicklung und Demo — ohne Kosten
• Mainnet-Zahlungen mit USDC über produktive Facilitators auf unterstützten Netzwerken wie Base oder Solana
• AI-Agent-Zugriff auf TYPO3-Headless-APIs

Was noch fehlt:

• Native Fiat-Rails im Kernprotokoll
• Wallet-Connect-UI-Komponente für menschliche Besucher:innen (unser v1.2-Ziel)
• Backend-Dashboard mit Umsatz-Analytics (unser v1.1-Ziel)

Installation  

# Verifizierter Einstiegspunkt:
# https://github.com/dirnbauer/typo3-x402-paywall

Dann in Ihrer Site-Configuration:

# config/sites/<identifier>/config.yaml
x402_paywall:
  enabled: true
  wallet_address: "0xIHRE_WALLET_ADRESSE"
  network: "base-sepolia"  # Testnet zum Ausprobieren
  default_price: "0.01"
  gated_route_patterns:
    - "/api/v1/content/*"

Roadmap  

Serie: EmDash-Ideen für TYPO3  

Dieser Artikel ist Teil 2 einer Serie, in der wir die besten Architektur-Ideen aus Cloudflares EmDash auf TYPO3 übertragen:

1. Capability Manifests — Extension-Security durch deklarative Fähigkeits-Manifests
2. x402 Paywall — Content-Monetarisierung für AI-Agents (dieser Artikel)
3. MCP-Server für TYPO3 — siehe Agent Skills FAQ: MCP-Integration
4. AI Agent Skills für TYPO3 — siehe Agent Skills: 30 Fragen und Antworten und unser Skills-Repository auf GitHub

Fazit  

x402 löst ein Problem, das die meisten TYPO3-Agenturen heute noch nicht spüren — aber bald werden. Wenn AI-Agents 10%, 20%, 50% des Traffics auf Content-Websites ausmachen, brauchen Publisher:innen einen Weg, für diesen Zugriff bezahlt zu werden. x402 ist der erste ernstzunehmende Standard dafür.

Für TYPO3 bedeutet das: Eine PSR-15-Middleware, eine YAML-Konfiguration, und Ihre Headless-API bekommt einen klaren Pfad zur Monetarisierung. Heute auf dem Testnet ausprobieren; für Produktion brauchen Sie zusätzlich eine belastbare Facilitator-, Wallet- und Compliance-Entscheidung.

Die wichtigsten Erkenntnisse:

• x402 ist kein reines Zukunfts-Experiment — die offizielle Doku deckt inzwischen Testnet-, Mainnet- und MCP-Szenarien ab
• Die TYPO3-Integration ist eine Middleware-Konfiguration, kein Infrastrukturprojekt
• Testnet-Modus ermöglicht risikofreies Ausprobieren
• AI-Agent-Monetarisierung wird zur strategischen Notwendigkeit