Digitale Inhalte zu monetarisieren, ohne Nutzer:innen in ein Abo-Modell zu zwingen, war lange ein ungelöstes Problem im Web. Das x402-Protokoll greift hier auf einen fast vergessenen HTTP-Statuscode zurück: 402 „Payment Required". Statt einer Abo-Logik signalisiert der Server bei gesperrten Inhalten schlicht einen 402 — und der Client bezahlt per On-Chain-Micropayment, ohne Login, ohne Kreditkarte.
Die TYPO3-x402-Paywall-Extension bringt diesen Ansatz nach TYPO3 v14 — und denkt dabei sowohl klassische Browser-Besucher:innen als auch KI-Agenten-HTTP-Traffic mit. Ein einheitlicher Mechanismus, der ohne Subscription-Logik auskommt und TYPO3 zur Zahlungsschicht für beide Zielgruppen macht.
Inhaltsverzeichnis
Überblick
Funktionen im Detail
Installation
Fazit
Überblick
Das x402-Protokoll ist ein offener Standard für HTTP-Micropayments: Antwortet ein Server mit HTTP 402, teilt er dem Client gleichzeitig mit, welche Zahlung erwartet wird — Betrag, Währung, Netzwerk, Empfängeradresse. Der Client führt die On-Chain-Transaktion durch, hängt den Payment-Proof als HTTP-Header an und wiederholt den Request. Der Server prüft den Proof und liefert den Inhalt aus. Kein Intermediär, kein Account, kein Passwort.
Die TYPO3-x402-Paywall-Extension implementiert diesen Ablauf als PSR-15-Middleware: Sie überwacht konfigurierte Seiten-UIDs und Route-Patterns, gibt bei fehlendem oder ungültigem Payment-Proof einen 402 zurück und lässt validierte Requests durch. Der Ansatz bleibt bewusst infrastrukturnah: Die Zahlungslogik liegt im HTTP-Protokoll, nicht in der Applikation.
Ein besonderer Schwerpunkt liegt auf KI-Agenten-Traffic. Über gated_route_patterns in der Site-YAML lassen sich API-Routen definieren, die programmatisch von HTTP-Clients angesteuert werden — ohne Browser, ohne UI. KI-Coding-Agenten und LLM-Workflows, die TYPO3-Inhalte konsumieren, bezahlen dabei nach demselben Protokoll wie menschliche Besucher:innen. Das macht TYPO3 zur Zahlungsschicht für eine neue Kategorie von Konsument:innen.
Diese Extension setzt TYPO3 ^14.3 und PHP ^8.2 voraus. On-Chain-Zahlungen über öffentliche Netzwerke (Base, Polygon, Ethereum) setzen eine funktionierende Netzwerkkonfiguration und einen x402-kompatiblen Payment-Facilitator voraus. Für Tests steht Base Sepolia als Testnetzwerk zur Verfügung.
x402-Zahlungsdashboard: Umsatz, freigeschaltete Seiten und Transaktionsstatus werden dort sichtbar, wo Redakteur:innen die geschützten Inhalte pflegen.
Funktionen im Detail
Die PSR-15-Middleware ist der Kern der Extension. Sie wird in den TYPO3-Middleware-Stack eingehängt und prüft bei jedem Request, ob die aufgerufene URL einer Paywall-Konfiguration unterliegt. Ist das der Fall und fehlt ein gültiger Payment-Proof im X-PAYMENT-Header, antwortet sie mit HTTP 402 und einem maschinenlesbaren Payment-Requirements-Objekt.
Für KI-Agenten und programmatischen HTTP-Traffic stehen gated_route_patterns in der Site-YAML zur Verfügung. Diese regulären Ausdrücke erfassen API-Pfade und unterwerfen sie denselben 402-Regeln wie Seiten-UIDs — ohne dass dafür explizite TYPO3-Seiten existieren müssen.
Ergänzend bringt die Extension MCP-Tools mit, die Seiten-Discovery, Probing des Payment-Status, Statistiken und Transaktionslisten über das Model Context Protocol verfügbar machen. Ein optionales React/Next.js-Begleitpaket erleichtert die Integration in Headless-TYPO3-Setups.
Installation
composer config repositories.typo3-x402-paywall vcs https://github.com/dirnbauer/typo3-x402-paywall.git
composer require webconsulting/typo3-x402-paywallHäufige Fragen
Fazit
TYPO3 als Zahlungsschicht — ohne Subscription-Logik, ohne Intermediäre, auf Basis eines offenen HTTP-Standards. Die x402-Paywall-Extension zeigt, dass die Monetarisierung von Webinhalten und KI-Agenten-Traffic dieselbe technische Grundlage teilen kann. Per-Seiten-Konfiguration, PSR-15-Middleware und MCP-Tools machen den Ansatz für klassische TYPO3-Redaktionsworkflows ebenso nutzbar wie für agentenbasierte Systeme.
Die Extension nutzt das x402-Protokoll und die PSR-15-Middleware-Architektur von TYPO3 v14. Dank an das TYPO3-Core-Team und die Community. Die Extension steht unter der GPL-Lizenz.