Proxy-seller

Zahlungen

Aktualisiert:

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

Endpunkt

Wofür Sie bezahlen

Wer kann bezahlen?

POST /orders

Ein neuer Auftrag

Beliebiges Wallet; es wird zum Eigentümer des Auftrags

POST /orders/{id}/items/{line_id}/renew

Erneuerung einer Bestellzeile

Nur das Wallet, über das der Auftrag bezahlt wurde

POST /orders/{id}/traffic

Privater Verkehr

Nur das Wallet, über das der Auftrag bezahlt wurde

POST /topup

Guthabenaufladung für die automatische Verlängerung

Beliebige Wallet; der Kontostand dieser Wallet wird gutgeschrieben

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

Zahlungsüberschriften
das genaue Format von PAYMENT-REQUIRED, PAYMENT-SIGNATURE und PAYMENT-RESPONSE
Wiederholungsversuche und Idempotenz
Was ist zu tun, wenn das Netzwerk oder die API während des Zahlungsvorgangs ausfällt?
Auftrag annehmen
Status und Zugangsdaten

FAQ

Nein. Die signierte Autorisierung wird für Sie an das Netzwerk übermittelt.

Fordern Sie ein neues Angebot an. Wenn Sie bereits eine unterschriebene Anfrage mit einem abgelaufenen Angebot gesendet haben, erfahren Sie in der Antwort, wie Sie vorgehen müssen: 402 quote_expired wird direkt in der Antwort mit einem neuen Zitat ergänzt; 409 payment_not_settleable bedeutet, dass Ihre vorherige Autorisierung noch ausgeführt werden kann; warten Sie also, bis authorization_expires_at bevor Sie einen neuen Vertrag unterzeichnen.

Nein. Eine Autorisierung kann im Netzwerk nur einmal ausgeführt werden, und die Wiederholung derselben PAYMENT-SIGNATURE gibt das Ergebnis des ersten Versuchs zurück. Unterzeichnen Sie keine neue Autorisierung, solange die vorherige noch ausgeführt werden kann: In Fehlermeldungen wird angegeben, bis wann (authorization_expires_at).

Wiederholen Sie dieselbe Anfrage mit denselben PAYMENT-SIGNATURE. Das ist unbedenklich: Sie erhalten das Ergebnis des ersten Versuchs.

Nicht über die API. Kontakt [email protected] mit der Auftrags-ID.

Falls vorhanden, wird dessen Adresse im Katalog wie folgt veröffentlicht: protocol.sandbox_url.

On this page

Der Ablauf
1
Angebot anfordern
2
Unterzeichnen Sie die Vollmacht
3
Wiederholen Sie die Anfrage mit der Signatur
4
Ergebnis abfragen
Bevor du beginnst
Gilt für alle kostenpflichtigen Endpunkte
Bezahlte Endpunkte
Wie lange es dauert
Nachdem Sie bezahlt haben
FAQ
Zahlungen | Proxy-seller