API Reference
Dashboard
  1. API Reference
  2. ProxyMarket API
  3. Webhooks

A customer paid, deliver their proxy or VPN

ProxyMarket calls this the moment a customer's payment clears. Check X-Signature, find your product by external_plan_id, create the customer's access, and answer one of three ways:

  • provisioned (best): put the proxy login, or vpn_config_file, in the answer. The customer sees it at once.
  • pending: you need more time. Then send it with Deliver the proxy login or VPN config within 5 minutes.
  • error: you cannot deliver, with a message. ProxyMarket refunds the customer automatically and takes back your earning.

Save order_id: later calls about this order use it. The payload is the same for proxy, VPN and VLESS orders.

  • Action · reversible
  • ProxyMarket signature (X-Signature)
  • provisionWebhook
POST/provision

Header parameters

X-ProxyMarket-Eventstringrequired

Which event this call is.

Example order.provision

Request body application/json · required

order_idstringrequired

ProxyMarket order ID. Keep it: credentials, expiry and the other webhooks use it.

external_plan_idstringrequired

The external_id you synced. It tells you which port, modem or VPN pool to use.

customer_idstringrequired

ProxyMarket customer ID, for your own records. The customer never sees it.

quantityintegerrequired

How many were ordered (usually 1).

duration_daysintegerrequired

How long the customer paid for, in days, or hours when duration_unit is hours.

duration_unitstringrequired
One of days, hours
bandwidth_gbnumber | nullrequired

Data limit in GB. null means unlimited.

plan_namestringrequired

Name of the plan.

total_usdnumberrequired

What the customer paid.

provisioned_atstring (date-time)required

When the payment cleared (UTC).

Authentication

Check X-Signature before anything else; answer 401 when it does not match. See the guide for code.

Responses

Your answer. status is provisioned, pending or error; with provisioned, include the proxy login (all four fields) or vpn_config_file.

statusstringrequired
One of provisioned, pending, error
proxy_ipstringoptional
proxy_portintegeroptional
proxy_usernamestringoptional
proxy_passwordstringoptional
rotation_linkstringoptional
vpn_config_filestringoptional

Full client file for VPN and VLESS orders.

expires_atstring (date-time)optional

When access ends on your side.

messagestringoptional

With status error, why you cannot deliver.

Verified against ProxyMarket vendor guide v1.11 on Nov 20, 2026