Pagamenti
Updated:
Ogni endpoint a pagamento utilizza lo stesso ciclo di due richieste del protocollo x402: la prima richiesta restituisce il prezzo, la seconda lo paga.
Il flusso
Richiedi un preventivo
POST /orders(oppure/renew,/traffic,/topup) senza intestazioni di pagamentoRisultati
402 Payment Required: il preventivo nel corpo del testo e i requisiti di pagamento nelPAYMENT-REQUIREDintestazione. Non viene riservato né addebitato nulla.Firmare l’autorizzazione
EIP-3009 transferWithAuthorizationFirmare un trasferimento USDC per un importo esatto di
amountapayTocon il tuo portafoglio. Una firma da sola non trasferisce fondi.Ripetere la richiesta con la firma
Stesso metodo, percorso e corpo del testo, più
PAYMENT-SIGNATURERisultati
202 Acceptedcon l’ID dell’operazione, il relativo stato e, per i nuovi ordini e le ricariche, un token di accesso. IlPAYMENT-RESPONSEL'intestazione contiene la transazione.Votare il risultato
GET /orders/{id}oppureGET /topup/{id}Il pagamento viene prima confermato sulla rete, poi l’operazione viene eseguita. Effettuare un polling ogni
next_poll_after_secondsfino a quandostatus_is_terminalètrue.
Prima di iniziare
Portafoglio con USDC su Base — il pagatore. Non è necessario alcun ETH per il gas.
client x402 — qualsiasi client con x402 versione 2, il
exactscheme ed EIP-3009, oppure il proprio codice (Intestazioni di pagamento).Termini attuali — le versioni da
catalog.termsapprofondisciaccept_termsdi un nuovo ordine.
Elementi comuni a tutti gli endpoint a pagamento
URL di base
https://proxy-seller.com/api/x402/v1Protocollo di pagamento
x402 versione 2, schema exact, metodo di trasferimento EIP-3009, flusso upfront: il pagamento avviene prima dell’evasione dell’ordine. L’intestazione della versione 1 X-PAYMENT viene rifiutato.
Citazione
Una citazione dura 15 minuti (quote_expires_at). La richiesta a pagamento deve riportare il testo della richiesta gratuita; solo idempotency_key, callback_url e auto_renew possono variare.
Modello di errore
Codici di stato HTTP reali e un corpo JSON con retry_action che spiega cosa fare dopo (Errori).
Endpoint a pagamento
Endpoint | Cosa paghi | Chi può pagare |
|---|---|---|
| Un nuovo ordine | Qualsiasi portafoglio; diventa il proprietario dell’ordine |
| Rinnovo di una riga d’ordine | Solo il portafoglio con cui è stato pagato l’ordine |
| Traffico residenziale | Solo il portafoglio con cui è stato pagato l’ordine |
| Ricarica di saldo per il rinnovo automatico | Qualsiasi portafoglio; il saldo di questo portafoglio viene accreditato |
Quanto tempo ci vuole
Dopo il 202 Una volta confermato il pagamento sulla rete Base, l’ordine viene evaso. I proxy sono solitamente pronti nel giro di pochi minuti. I proxy mobili vengono emessi manualmente dal nostro staff: sono necessarie fino a 3 ore.
Un'operazione a pagamento non va mai persa. Se una fase fallisce, l'operazione rimane in attesa del nostro staff e il pagamento non viene addebitato due volte.
Dopo aver effettuato il pagamento
Domande frequenti
No. L’autorizzazione firmata viene inviata alla rete per conto tuo.
Richiedi un nuovo preventivo. Se hai già inviato una richiesta firmata con un preventivo scaduto, la risposta ti indicherà cosa fare: 402 quote_expired viene fornita una nuova citazione direttamente nella risposta; 409 payment_not_settleable significa che la tua autorizzazione precedente può ancora essere eseguita, quindi attendi fino a quando authorization_expires_at prima di firmarne uno nuovo.
No. Un’autorizzazione può essere eseguita sulla rete una sola volta, e ripetere la stessa PAYMENT-SIGNATURE restituisce il risultato del primo tentativo. Non firmare una nuova autorizzazione finché quella precedente può ancora essere eseguita: le risposte di errore indicano fino a quando (authorization_expires_at).
Ripetere la stessa richiesta con lo stesso PAYMENT-SIGNATURE. È sicuro: si ottiene il risultato già al primo tentativo.
Non tramite l’API. Contattare [email protected] con l'ID dell'ordine.
Se disponibile, il suo indirizzo viene pubblicato nel catalogo come protocol.sandbox_url.