HTTP 402 Payment Required: was es bedeutet und wie x402 es nutzt
402 ist der HTTP-Statuscode für eine Anfrage, die vor der Bearbeitung eine Zahlung erfordert. Die meiste Zeit seiner Geschichte hatte er kein standardisiertes Format. x402 gibt ihm eines.
Key takeaways
-
402 Payment Required ist ein Client-Fehler: Die Anfrage ist gültig, aber der Server will zuerst eine Zahlung.
-
HTTP/1.1 reservierte 402 für die künftige Verwendung und definierte nie, wie die Zahlung funktionieren sollte, sodass jede API ihn anders nutzte.
-
x402 definiert die fehlenden Teile: einen PAYMENT-REQUIRED-Header mit maschinenlesbaren Bedingungen und eine signierte Zahlung beim erneuten Versuch.
Was 402 Payment Required bedeutet
Eine 402-Antwort teilt dem Client mit, dass die Anfrage selbst in Ordnung ist, aber erst nach einer Zahlung bearbeitet wird. Sie gehört zur 4xx-Familie, weil als Nächstes der Client handeln muss, nicht der Server.
402 unterscheidet sich von 401 Unauthorized und 403 Forbidden. 401 verlangt Zugangsdaten, 403 lehnt die Anfrage rundweg ab, und 402 verlangt eine Zahlung.
Warum 402 so lange ungenutzt blieb
Der Code wurde bei der Ausarbeitung von HTTP/1.1 reserviert, in der Erwartung, dass später eine Form von digitalem Geld entstehen würde. Die Spezifikation legte nie fest, was ein 402-Body enthalten oder wie ein Client zahlen sollte, sodass Browser darauf nie reagierten.
Ohne ein gemeinsames Format nutzten APIs, die tatsächlich 402 zurückgaben, ihn als einfachen Fehler: ein Konto ohne Guthaben, eine abgelehnte Karte oder ein erreichtes Plan-Limit.
Wann APIs heute 402 zurückgeben
402 begegnet Ihnen in zwei grundlegenden Situationen.
- Abrechnungsfehler im Konto: Der Key ist gültig, aber Guthaben, Kontingent oder Abo decken die Anfrage nicht ab. Die Lösung ist Aufladen oder ein Upgrade.
- Pay-per-Request-Angebote: Der Server liefert Zahlungsbedingungen zurück, und der Client kann zahlen und dieselbe Anfrage erneut senden. So funktioniert x402.
Wie x402 aus 402 einen Zahlungsablauf macht
x402 legt maschinenlesbare Bedingungen in einen PAYMENT-REQUIRED-Header: Betrag, Zahlungsmittel, Netzwerk und Empfänger. Ein Client signiert für diese Bedingungen eine Stablecoin-Autorisierung, sendet sie in einem PAYMENT-SIGNATURE-Header zurück und erhält die Antwort mit einer PAYMENT-RESPONSE-Quittung.
Da der gesamte Austausch reines HTTP ist, kann ein KI-Agent mit einer Wallet einen API-Aufruf bezahlen, ohne sich anzumelden oder einen API Key zu speichern.
Einen 402 im eigenen Client behandeln
Prüfen Sie zunächst, ob ein PAYMENT-REQUIRED-Header vorhanden ist. Falls ja, ist die Antwort ein x402-Angebot, das ein x402-Client bezahlen kann. Falls nicht, lesen Sie den Fehlertext: Meist bedeutet er, dass das Konto mehr Guthaben oder einen anderen Plan braucht.
HTTP-402-FAQ
Ist 402 Payment Required ein Fehler?
Es ist ein Client-Fehler im 4xx-Bereich, bedeutet aber nicht, dass die Anfrage fehlerhaft war. Es bedeutet, dass eine Zahlung nötig ist, bevor der Server fortfährt.
Was ist der Unterschied zwischen 402 und 401?
401 bedeutet, dass der Server gültige Zugangsdaten benötigt. 402 bedeutet, dass der Server eine Zahlung benötigt. Eine API kann 401 für einen ungültigen Key und 402 für einen gültigen Key ohne Guthaben zurückgeben.
Behandeln Browser 402 automatisch?
Nein. Browser zeigen einen 402 wie jede andere Fehlerseite an. Automatische Zahlung erfordert einen Client, der ein Protokoll wie x402 versteht.
Welche APIs nutzen 402 mit x402?
Jeder Server, der das x402-Protokoll implementiert. RunAPI gibt x402-Angebote auf seinen nutzungsbasierten KI-Modell-Endpoints zurück, sodass ein Agent Bild-, Video-, Musik- und Audiogenerierung in USDC bezahlen kann.
Verwandte Seiten
Testen Sie einen 402, den Sie wirklich bezahlen können
Senden Sie ohne Key eine Anfrage an einen nutzungsbasierten RunAPI-Endpoint und prüfen Sie das zurückgegebene x402-Angebot.