x402 für TYPO3: Wie Ihre Internetseite Geld von Computerprogrammen verlangt

Das Wichtigste in Kürze  

• x402 ist ein offenes Protokoll für Zahlungen im Internet. Es nutzt den HTTP-Statuscode 402. Dieser Code fordert Zahlungen direkt im Internet. Die Firma Coinbase hat den Standard früh gestartet. Die aktuellen Dokumente beschreiben ihn als offenes System.
• Der Hauptnutzen: Ein AI-Agent bezahlt automatisch für den Zugriff auf Inhalte. Ein AI-Agent ist ein intelligentes Computerprogramm. Es braucht keine Konten. Es braucht keine Passwörter. Es braucht keine Kassenseiten.
• Die offiziellen Dokumente zu x402 erklären viele Dinge sehr gut. Sie erklären den Start für Verkäufer. Sie erklären auch echte Zahlungen. Das System wächst sehr deutlich.
• Unsere neue TYPO3-Erweiterung heißt typo3-x402-paywall. Die Erweiterung baut das System als Middleware ein. Eine Middleware ist ein Vermittler im Hintergrund. Es klappt für moderne Schnittstellen und klassische Frontends. Ein Frontend ist die sichtbare Internetseite.
• Die Erweiterung bringt die Datei Capabilities.yaml mit. Das ist eine Liste mit allen Fähigkeiten der Erweiterung. Wir wenden damit unsere eigenen Empfehlungen an.

Inhalt  

Das Verdienen von Geld im Internet wird schwerer. Werbung auf Internetseiten bringt Geld ein. Dafür müssen Menschen die Seite besuchen. Die Menschen müssen die Werbung ansehen.

Aber heute besuchen oft Computerprogramme die Internetseiten. Diese Programme heißen AI-Agent. Die Programme lesen Texte für andere Menschen. Der AI-Agent sieht keine Werbung. Der AI-Agent klickt nicht auf Links. Er kauft auch kein Abonnement.

Die Macher von Internetseiten brauchen neue Wege. Sie wollen Geld für ihre gute Arbeit bekommen. Das Protokoll x402 löst genau dieses Problem.

Was ist x402?

Das Protokoll x402 nutzt den Code 402 Payment Required aus dem HTTP-Standard. Dieser Fehlercode fordert eine Zahlung. Der Code ist seit dem Jahr 1997 bekannt. Aber das Internet nutzt ihn bisher kaum.

Das Prinzip: Ein Programm fordert Daten an. Die Daten kosten Geld. Der Server sendet den Code 402 zurück. Der Server sendet auch die Bedingungen für die Zahlung. Das Programm bezahlt das Geld sofort. Dann fragt das Programm noch einmal nach den Daten. Dieses Mal schickt das Programm einen Beweis für die Zahlung.

Warum jetzt?

Drei Dinge machen x402 gerade jetzt sehr wichtig:

1. Ein AI-Agent braucht Inhalte  

Claude, GPT und andere Programme fragen oft Daten im Internet ab. Sie holen die Informationen für ihre Nutzer. Jeder Zugriff auf diese Daten hat einen Wert. Aber bisher gibt es keinen einheitlichen Weg für die Bezahlung.

2. Stablecoins erlauben winzige Zahlungen  

Eine Zahlung von wenigen Cent war früher sehr teuer. Die Gebühren bei Kreditkarten waren zu hoch. Ein Stablecoin löst dieses Problem. Ein Stablecoin ist digitales Geld mit sehr festem Wert. Diese Technik macht kleinste Zahlungen heute gut und günstig möglich.

3. Das Umfeld wächst stark  

Unsere TYPO3-Erweiterung: typo3-x402-paywall

Die Erweiterung webconsulting/typo3-x402-paywall baut x402 als PSR-15-Middleware in TYPO3 ein. Das ist ein technischer Vermittler im Hintergrund. Die Middleware bietet zwei verschiedene Wege an:

# 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"
  }
}

Aufbau

Ausprobieren: x402 in Aktion

Sehen Sie sich die Zahlung mit x402 genau an. Wir zeigen Ihnen den Weg von der Anfrage bis zur Antwort:

Anfrage erscheint nach Start...

Antwort erscheint nach Simulation...

Ereignisse: Eigene Logik anbinden

Die Erweiterung löst zwei Events aus. Ein Event ist ein technisches Ereignis. Sie können eigene Funktionen an diese Ereignisse hängen:

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

#[AsEventListener]
final class PaywallAnalyticsListener
{
    public function __invoke(PaymentRequiredEvent $event): void
    {
        // Aufzeichnung: Welche Inhalte wollen die Nutzer sehen?
        $this->logger->info('Paywall hit', [
            'uri' => $event->requestUri,
            'price' => $event->price,
        ]);
    }
}

Fähigkeiten-Liste: Offenheit durch klare Angaben

Die Erweiterung bringt eine Datei mit dem Namen Capabilities.yaml mit. Das ist eine offene Liste für alle Fähigkeiten. Wir setzen damit unser eigenes Konzept genau um. Wir haben das im ersten Teil dieser Serie genau erklärt:

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 Betreuer der Internetseite sieht alles sofort. Diese Erweiterung fängt Anfragen ab. Sie liest die Tabelle mit den Seiten. Sie spricht nur mit einem einzigen fremden Computer. Dieser fremde Computer heißt Facilitator. Er prüft die Zahlungen. Es gibt absolut keinen freien Zugriff auf das restliche Netzwerk.

Für wen ist das wichtig?

Aktuelle Grenzen und Ausblick

Was heute schon funktioniert:

• Ein Test-Modus für Entwickler ohne echte Kosten.
• Echte Zahlungen mit dem digitalen Geld USDC in schnellen Netzwerken.
• Automatischer Zugriff von einem AI-Agent auf moderne TYPO3-Schnittstellen.

Was noch fehlt:

• Wege für normales Geld direkt im Kern vom System.
• Eine einfache Anzeige für echte menschliche Besucher.
• Eine gute Auswertung der Zahlungen im TYPO3-Backend.

Einbau

# Geprüfter Startpunkt:
# https://github.com/dirnbauer/typo3-x402-paywall

Schreiben Sie diese Zeilen in Ihre Konfiguration für die Seite:

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

Plan

Serie: Ideen für TYPO3

Dieser Text ist der zweite Teil einer Serie. Wir übertragen die besten Ideen vom fremden System EmDash auf TYPO3:

1. Fähigkeiten-Listen — Sicherheit für Erweiterungen durch offene und klare Listen.
2. x402 Bezahlschranke — Echtes Geld für Inhalte von Künstlicher Intelligenz (dieser Text).
3. MCP-Server für TYPO3 — Ein MCP-Server verbindet Werkzeuge. Lesen Sie dazu unser Dokument zu Fähigkeiten.
4. Fähigkeiten von AI-Agents für TYPO3 — Lesen Sie dazu 30 Fragen und Antworten. Sie finden auch unser Verzeichnis auf GitHub.

Zusammenfassung  

Das System x402 löst ein großes Problem für Internetseiten. Viele TYPO3-Agenturen spüren das Problem heute noch nicht. Aber sie werden das Problem bald sehr spüren. Ein AI-Agent fragt oft viele Inhalte von Internetseiten ab. Die Erfinder der Inhalte brauchen einen Weg für die automatische Bezahlung. Das System x402 ist der erste sehr gute Standard dafür.

Für TYPO3 bedeutet das: Sie brauchen einen Vermittler im Hintergrund. Sie brauchen ein paar einfache Einstellungen. Dann kann Ihre moderne Schnittstelle sofort Geld verlangen. Sie können das heute schon ohne echtes Geld testen. Für echte Einnahmen brauchen Sie eine gute digitale Geldbörse.

Die wichtigsten Erkenntnisse:

• x402 ist nicht nur ein kleiner Versuch für die Zukunft. Die offiziellen Dokumente beschreiben bereits echte Anleitungen für Geld.
• Der Einbau in TYPO3 ist nur eine kleine Einstellung. Es ist kein großes technisches Bauprojekt.
• Der Test-Modus macht das Ausprobieren absolut sicher und einfach.
• Das automatische Bezahlen durch Künstliche Intelligenz wird sehr bald extrem wichtig.