Sequenza delle azioni
Updated:
Acquista proxy con una sola richiesta a pagamento — senza account, senza chiave API.
Il flusso
Controlla il catalogo
GET /catalogVerificare prodotti, paesi, periodi, prezzi, gli scopi di utilizzo consentiti e le condizioni vigenti.
Richiedi un preventivo
POST /ordersInvia l’ordine senza effettuare il pagamento. Resi
402 Payment Requiredcon il prezzo esatto. Non viene addebitato alcun costo.Retribuzione
POST /ordersconPAYMENT-SIGNATURERipetere la stessa richiesta con il pagamento firmato. Resi
202 Accepted, l’ID dell’ordine e il token di accesso.Ottenere i proxy
GET /orders/{id}Interrogare l'ordine con il token di accesso finché non viene
active. La risposta contiene i proxy con le relative credenziali.
Prima di iniziare
Portafoglio con USDC su Base — sufficiente per l’ordine. Non è necessario alcun ETH.
Prodotti, paesi e periodi — da Catalogo.
Finalità d’uso e termini — valori tratti da
catalog.intended_useecatalog.terms.
Elementi comuni a tutti gli endpoint dell’ordine
URL di base
https://proxy-seller.com/api/x402/v1Autenticazione
POST /orders viene autenticato dal pagamento stesso. Tutti gli altri endpoint accettano il token di accesso dell’ordine: Authorization: Bearer <access_token>.
Modello di errore
Codici di stato HTTP reali e un corpo JSON con retry_action (Errori).
Dopo aver effettuato un ordine
Domande frequenti
Di solito pochi minuti dopo il 202 Risposta: il pagamento viene prima confermato sulla rete Base, poi vengono emessi i proxy. I proxy per dispositivi mobili vengono emessi manualmente dal nostro staff: sono necessarie fino a 3 ore. Sondaggio GET /orders/{id} ogni next_poll_after_seconds.
Sì. Un ordine comprende un prodotto e fino a 20 righe; ogni riga ha il proprio paese (o pacchetto MIX), quantità e periodo.
No. Effettua un ordine separato per ciascun prodotto.
Recupera l'accesso Elenca tutti gli ordini presenti nel tuo portafoglio con i nuovi token di accesso.
La disponibilità non è garantita prima del pagamento. Se i proxy non possono essere emessi in tempo, l’ordine viene visualizzato come delayed: true, e in seguito provisioning_failed mentre il nostro staff li emette manualmente. L’ordine diventa active da sé una volta emessi i proxy. È inoltre possibile contattare l’assistenza per richiedere un rimborso.
Non tramite l’API. Contattare [email protected] con l'ID dell'ordine.
No. Gli ordini acquistati tramite x402 vengono gestiti esclusivamente tramite l’API x402.