Zahlungen

Jeder kostenpflichtige Endpunkt nutzt denselben Zwei-Anfragen-Zyklus des x402-Protokolls: Die erste Anfrage liefert den Preis, die zweite begleicht ihn.

Der Ablauf

1. Angebot anfordern

   POST /orders (oder /renew, /traffic, /topup) ohne Zahlungsangaben

   Ergebnisse 402 Payment Required: das Zitat im Textkörper und die Zahlungsbedingungen in der PAYMENT-REQUIRED Kopfzeile. Es wird nichts reserviert oder in Rechnung gestellt.

2. Unterzeichnen Sie die Vollmacht

   EIP-3009 transferWithAuthorization

   Unterzeichnen Sie eine USDC-Überweisung über genau amount zu payTo mit Ihrer Wallet. Eine Signatur allein bewirkt keine Geldübertragung.

3. Wiederholen Sie die Anfrage mit der Signatur

   Gleiche Methode, Pfad und Hauptteil sowie PAYMENT-SIGNATURE

   Ergebnisse 202 Accepted mit der Vorgangs-ID, dem Status und – bei neuen Bestellungen und Aufladungen – einem Zugriffstoken. Die PAYMENT-RESPONSE Der Header enthält die Transaktion.

4. Ergebnis abfragen

   GET /orders/{id} oder GET /topup/{id}

   Die Zahlung wird zunächst im Netzwerk bestätigt, dann wird der Vorgang ausgeführt. Abfrage alle next_poll_after_seconds bis status_is_terminal ist true.

Bevor du beginnst

• Wallet mit USDC auf Base – der Zahler. Es wird kein ETH für Gas benötigt.

• x402-Client – jeder Client mit x402 Version 2, der exact Scheme und EIP-3009 oder Ihren eigenen Code (Zahlungsüberschriften).

• Aktuelle Begriffe – die Versionen aus catalog.terms weiter zu accept_terms einer neuen Bestellung.

Gilt für alle kostenpflichtigen Endpunkte

Basis-URL

https://proxy-seller.com/api/x402/v1

Zahlungsprotokoll

x402 Version 2, Schema exact, Übertragungsmethode EIP-3009, Ablauf upfront: Sie bezahlen, bevor der Auftrag ausgeführt wird. Die Kopfzeile der Version 1 X-PAYMENT wird abgelehnt.

Zitat

Ein Zitat bleibt 15 Minuten lang gültig (quote_expires_at). Der kostenpflichtige Auftrag muss den Text des kostenlosen Auftrags wiederholen; nur idempotency_key, callback_url und auto_renew können abweichen.

Fehlermodell

Echte HTTP-Statuscodes und ein JSON-Body mit retry_action die erklärt, was als Nächstes zu tun ist (Fehler).

Bezahlte Endpunkte

Wie lange es dauert

Nach dem 202 Sobald die Zahlung im Base-Netzwerk bestätigt ist, wird der Auftrag ausgeführt. Proxys sind in der Regel innerhalb weniger Minuten bereit. Mobile Proxys werden manuell von unseren Mitarbeitern ausgestellt: Rechnen Sie mit einer Bearbeitungszeit von bis zu 3 Stunden.

Ein bezahlter Vorgang geht niemals verloren. Sollte ein Schritt fehlschlagen, wird der Vorgang von unseren Mitarbeitern weiterbearbeitet, und der Betrag wird nicht doppelt abgebucht.

Nachdem Sie bezahlt haben

FAQ