Order actions
Updated:
Buy proxies with one paid request — no account, no API key.
The flow
Check the catalog
GET /catalogLook up products, countries, periods, prices, the allowed purposes of use and the current terms.
Request a quote
POST /ordersSend the order without payment. Returns
402 Payment Requiredwith the exact price. Nothing is charged.Pay
POST /orderswithPAYMENT-SIGNATURERepeat the same request with the signed payment. Returns
202 Accepted, the order id and the access token.Get the proxies
GET /orders/{id}Poll the order with the access token until it is
active. The response contains the proxies with their credentials.
Before you start
Wallet with USDC on Base — enough for the order. No ETH is needed.
Product, countries and periods — from Catalog.
Purpose of use and terms — values from
catalog.intended_useandcatalog.terms.
Common to all order endpoints
Base URL
https://proxy-seller.com/api/x402/v1Authentication
POST /orders is authenticated by the payment itself. All other endpoints take the order access token: Authorization: Bearer <access_token>.
Error model
Real HTTP status codes and a JSON body with retry_action (Errors).
After you've placed an order
FAQ
Usually a few minutes after the 202 response: the payment is confirmed on the Base network first, then the proxies are issued. Mobile proxies are issued manually by our staff: allow up to 3 hours. Poll GET /orders/{id} every next_poll_after_seconds.
Yes. An order has one product and up to 20 lines; each line has its own country (or MIX package), quantity and period.
No. Place a separate order for each product.
Recover access lists every order of your wallet with new access tokens.
Stock is not reserved before the payment. If the proxies cannot be issued in time, the order shows delayed: true, and later provisioning_failed while our staff issue them manually. The order becomes active by itself once the proxies are issued. You can also contact support about a refund.
Not through the API. Contact [email protected] with the order id.
No. Orders bought through x402 are managed only through the x402 API.