Paiements

Chaque point de terminaison payant utilise le même cycle de deux requêtes du protocole x402 : la première requête renvoie le prix, la seconde permet de le régler.

Le déroulement

1. Demander un devis

   POST /orders (ou /renew, /traffic, /topup) sans en-têtes de paiement

   Retour 402 Payment Required: le devis dans le corps du texte et les conditions de paiement dans le PAYMENT-REQUIRED En-tête. Aucune réservation ni aucun prélèvement n'ont été effectués.

2. Signer l'autorisation

   EIP-3009 transferWithAuthorization

   Signer un virement USDC d'un montant exact de amount à payTo avec votre portefeuille. Une signature seule ne permet pas de transférer des fonds.

3. Répétez la demande avec la signature

   Même méthode, chemin d'accès et corps, plus PAYMENT-SIGNATURE

   Retour 202 Accepted avec l'identifiant de l'opération, son statut et, pour les nouvelles commandes et les recharges, un jeton d'accès. Le PAYMENT-RESPONSE L'en-tête contient la transaction.

4. Consulter les résultats du sondage

   GET /orders/{id} ou GET /topup/{id}

   Le paiement est d'abord confirmé sur le réseau, puis l'opération est exécutée. Interroger toutes les next_poll_after_seconds jusqu'à ce que status_is_terminal est true.

Avant de commencer

• Portefeuille contenant des USDC sur Base — le payeur. Aucun ETH n'est nécessaire pour payer les frais de gaz.

• client x402 — tout client équipé de la version 2 de x402, le exact Scheme et EIP-3009, ou votre propre code (En-têtes de paiement).

• Termes actuels — les versions datant de catalog.terms aller dans accept_terms d'une nouvelle commande.

Commun à tous les points de terminaison payants

URL de base

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

Protocole de paiement

x402 version 2, schéma exact, méthode de transfert EIP-3009, flux upfront: vous payez avant que la commande ne soit traitée. L'en-tête de la version 1 X-PAYMENT est rejeté.

Citation

Une citation ne dure que 15 minutes (quote_expires_at). La demande payante doit reprendre le corps de la demande non payante ; uniquement idempotency_key, callback_url et auto_renew peuvent varier.

Modèle d'erreur

Codes d'état HTTP réels et corps JSON avec retry_action qui indique la marche à suivre (Erreurs).

Points de terminaison payants

Durée du projet

Après le 202 Réponse : une fois le paiement confirmé sur le réseau Base, la commande est traitée. Les proxys sont généralement prêts en quelques minutes. Les proxys mobiles sont attribués manuellement par notre équipe : veuillez prévoir jusqu’à 3 heures.

Une opération payante n'est jamais perdue. Si une étape échoue, l'opération est mise en attente par notre équipe, et l'argent n'est pas prélevé deux fois.

Une fois le paiement effectué

FAQ