HTTP 402 oder 503 bei x402-APIs: Wann darf ein Agent zahlen?
Anleitungen
Eine 402-Antwort kann aktuelle Zahlungsbedingungen liefern. Eine 503-Antwort meldet einen vorübergehend nicht verfügbaren Dienst. So reagiert ein x402-Client sicher.
Für einen x402-Client ist ein HTTP-Status ein Steuersignal. Eine Antwort ohne Erfolg ist nicht automatisch eine Zahlungsaufforderung. Der Client sollte die aktuelle Antwort des genauen Origins und der verwendeten Methode lesen, bevor er eine Zahlungsautorisierung erstellt.
HTTP 402 ist der Zahlungszweig des x402-Ablaufs, wenn die Antwort einen gültigen PAYMENT-REQUIRED-Header oder entsprechende Zahlungsbedingungen im Body enthält. Der Client kann Netzwerk, Asset, Betrag, Empfänger und Ressource prüfen, bevor er eine vollständige Option auswählt. Die Antwort ist ein Angebot von Bedingungen und kein Beweis für die Lieferung eines früheren Kaufs.
HTTP 503 hat eine andere Bedeutung: Der Server kann die Anfrage vorübergehend nicht bearbeiten. Ein Retry-After-Header kann nennen, wann der Client erneut prüfen soll. Die sichere Reaktion ist, vor der Zahlung zu stoppen, den Anfragekontext zu bewahren und erst nach der genannten Wartezeit oder einer späteren Statusprüfung erneut anzufragen.
Ein robuster Client verzweigt anhand der Live-Antwort. Bei 503 signiert und sendet er keine Zahlungsdaten. Bei 402 prüft er die genaue Ressource, Methode und vollständige Zahlungsbedingung, bevor er eine Ausgabenfreigabe anfragt. Bei einer widersprüchlichen Antwort, etwa einem Status für vorübergehende Nichtverfügbarkeit zusammen mit alten Zahlungsbedingungen, stoppt er und holt eine frische Antwort ein.
Eine Marktplatzzeile oder ein zwischengespeichertes Discovery-Dokument kann den aktuellen Origin nicht ersetzen. Vergleiche vor der Zahlung den Live-API-Vertrag, das x402-Discovery-Dokument und den öffentlichen Dienststatus. Ist eine gelistete Route pausiert oder fehlt sie im aktuellen Vertrag, bezahle nicht allein deshalb, weil ein externes Verzeichnis sie noch anzeigt.
Bewahre Antwortzeit, Status, Wiederholungshinweis, ausgewählte Zahlungsbedingung und spätere Zahlungsantwort als getrennte Belege auf. Abwicklung, Ausführung und Ergebnislieferung sind spätere Stufen. So kann der Betreiber genau eine Anfrage untersuchen, ohne eine vorübergehende Störung als Zahlungsanweisung zu deuten.