Create gate
Opens a new Datacenter Proxy order and charges your balance.
https://api.proxynet.io/api/v1/orders
The same pricing, plan discount, stock check and balance check apply. Protocol, location, target domains or all-sites mode, and all add-ons are supported.
If you don't send a username and password, they are generated and returned in the response (if the token also has proxies:read). If you don't send a service name, one is generated in the panel's format. Which fields apply to each type is in the table on the Operations that spend money page; unknown fields are rejected.
The order may not be active right away (provisioning, pre-order or a provider delay). If meta.ready is false, meta.warning is filled in; before you put the service to use, poll the Service details endpoint until state is active.
Authorization
Sent as Bearer <token>. This endpoint needs the orders:write (Ordering) scope; a token without it gets 403.
Headers
A unique value for each order attempt (e.g. a UUID). On a timeout, retry with the SAME value; you are not charged twice. Keep the value in a variable; don't generate a new one for the retry.
Body
Service type; datacenter on this page.
Required for ISP, Datacenter and Gaming. Get it from the GET /locations endpoint. The country is set from the location.
Required for ISP, Datacenter and Gaming, 1-1000. Without stock the order becomes a pre-order and needs at least 250.
ISP and Datacenter: the access mode is required. true = all sites (paid add-on); false needs a non-empty targetUrls list (targeted). If you send neither, the request is rejected, so you are never charged for a mode you did not choose. Not used on Gaming.
ISP and Datacenter, targeted mode: domains from the GET /target-urls list. Not sent when unlimitedAccess is true.
ISP, Datacenter and Gaming. auto: HTTP and SOCKS5 on the same port, plus UDP ASSOCIATE; http: HTTP/HTTPS only; socks5: SOCKS5 only. If not sent, ISP and Datacenter use auto and Gaming uses socks5 (default_protocol in the GET /catalog response). The parentUpstreamProtocol alias is also accepted (AUTO, HTTP or SOCKS; case-insensitive); send only one of the two. Not sent on Residential/Mobile; there, HTTP and SOCKS5 run at the same time on separate ports.
High connection. A paid add-on in the ISP family: 100 concurrent connections per IP instead of 50. Free on Residential/Mobile: the gateway connection limit is 1000 instead of 500; it shows in the response as options.high_connection.
ISP family only: extra IP whitelist allowance, charged per order. Returns 400 invalid_request on Residential/Mobile.
ISP family: non-sequential (scattered) IPs, paid add-on.
ISP family: 2× bandwidth, paid add-on.
Optional; if not sent, it is generated and returned in the response. 3-40 characters: letters, digits, _ or -. To choose it yourself, your plan must allow it; if it doesn't, you get tier_required.
Optional; if not sent, it is generated. 6-40 characters; @ . : ! and spaces are not allowed. It cannot be the same as the username. Percent-encode a password that contains # / ? % when you use it inside a URL (e.g. socks5://user:pass@host); passwords generated by the system never contain #.
Optional. The service name shown in the panel, up to 80 characters. If not sent, it is generated in the panel's format (e.g. ISP Proxy #a1b2c3d4).