Reseller API

Account

Your wallet balance, contracted per-proxy rate, and how many proxies you currently hold.

curl -H "Authorization: Bearer $KEY" \
  https://whitecloakproxy.com/api/reseller/v1/account

{
  "success": true,
  "name": "Partner Site",
  "balance_cents": 130000,
  "price_per_proxy_cents": 6500,
  "active_proxies": 12,
  "max_active_proxies": null,
  "billing_mode": "wallet"
}

• ◆All prices everywhere in this API are US cents — 6500 means $65.00.
• ◆Watch balance_cents and top up with us before it runs low; purchases fail cleanly with 402 when it can't cover them.
• ◆billing_mode is either "wallet" (the default, prepaid balance above) or "card" (pay-per-order — see the Purchase endpoint's card billing note). Card accounts always report balance_cents: null here and add a card block: { "last4": "4113", "brand": "VISA" }.

Inventory

Live purchasable stock, grouped by carrier and US state. Counts refresh continuously.

curl -H "Authorization: Bearer $KEY" \
  https://whitecloakproxy.com/api/reseller/v1/inventory

{
  "success": true,
  "total_available": 37,
  "stock": [
    { "carrier": "T-Mobile", "state": "FL", "count": 9 },
    { "carrier": "T-Mobile", "state": "NY", "count": 14 },
    { "carrier": "Verizon",  "state": "NY", "count": 8 },
    { "carrier": "Verizon",  "state": "TX", "count": 6 }
  ]
}

• ◆Stock can sell out between a check and a purchase — you'd get a clean 409, never a wrong proxy.

Purchase

Buy 1–20 proxies in one call. carrier and state are guarantees: every delivered proxy matches them, or the call fails before anything is charged.

curl -X POST \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "quantity": 2,
    "carrier": "Verizon",
    "state": "NY",
    "idempotency_key": "your-order-8841"
  }' \
  https://whitecloakproxy.com/api/reseller/v1/purchase

{
  "success": true,
  "purchased": [
    {
      "proxy_id": "1f6f2a34-....",
      "carrier": "Verizon",
      "state": "NY",
      "host": "relay7.pprx.io",
      "password": "kJ2mPq9xL4",
      "http":   { "port": 10412, "username": "u8842" },
      "socks5": { "port": 10413, "username": "u8842" },
      "rotation_url": "https://pprx.io/r/AbC123xYz",
      "expires_at": "2026-08-04T18:20:11.000Z"
    }
  ],
  "failed_count": 0,
  "charged_cents": 13000,
  "balance_cents": 117000
}

• ◆Always send an idempotency_key (e.g. your internal order ID). If your request times out and you retry with the same key, you get the original result back instead of being charged twice. A retry while the original is still processing returns 409 — wait and retry again.
• ◆Use a generous HTTP timeout (120s+): provisioning happens live, one device at a time.
• ◆Store proxy_id — it's the handle for extend and reset-password.
• ◆failed_count > 0 means some units couldn't be provisioned and were refunded automatically; purchased contains only real, working proxies.
• ◆Proxies run for 30 days from purchase.
• ◆Card billing (opt-in): card payments are processed by Intuit Payments Inc. (QuickBooks Payments). Accounts with billing_mode "card" skip the wallet entirely. We send you a one-time save-card link — card details are entered and tokenized client-side and never touch our servers — and every purchase after that charges the saved card directly, settling instantly. For these accounts balance_cents is always null and the response adds a payment block that doubles as your per-transaction receipt: { "method": "card", "charge_id": "MT1a2b3c4d", "last4": "4113", "paid_at": "<ISO timestamp>", "processed_by": "Intuit Payments Inc." }.
• ◆Card billing errors (billing_mode "card" only): 402 { "error": "No card on file. Save a card via your setup link before purchasing." } if you haven't saved a card yet; 402 with a card-specific reason (e.g. "Your card was declined. Please try a different card or contact your bank." or "Your card has expired. Please update your card details.") on a definitive decline; 502 { "error": "Payment status unknown — do not retry; contact support before trying again." } if we couldn't confirm the outcome after a timeout, or a plain 5xx if Intuit's payment_unavailable — in either 5xx case, do not retry blindly; contact support first.
• ◆Card billing partial failures: if some (not all) units fail to provision after a successful card charge, exactly one partial refund is issued automatically. refund_pending_cents plus a warning only appear if that refund itself failed (rare — our team is alerted) — same convention as the wallet path's refund_pending_cents.

List proxies

Every active (unexpired) proxy you hold, soonest-expiring first. Same unit shape as the purchase response.

curl -H "Authorization: Bearer $KEY" \
  https://whitecloakproxy.com/api/reseller/v1/proxies

{
  "success": true,
  "count": 12,
  "proxies": [ { "proxy_id": "...", "expires_at": "...", ... } ]
}

• ◆Poll this daily and renew anything expiring within a day or two — expired proxies are released back to the pool and cannot be recovered.

Extend

Extend one proxy by 30 days at your flat rate. Extending early never loses time — the 30 days stack onto the current expiry.

curl -X POST \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{"proxy_id": "1f6f2a34-...."}' \
  https://whitecloakproxy.com/api/reseller/v1/proxies/extend

{
  "success": true,
  "proxy_id": "1f6f2a34-....",
  "expires_at": "2026-09-03T18:20:11.000Z",
  "charged_cents": 6500,
  "balance_cents": 110500
}

• ◆Send one extend per proxy at a time: if two race, the second is detected, refunded, and answered with 409 — treat that as "already extended" and re-check GET /proxies.
• ◆A 410 means the proxy already expired and was released — it cannot be brought back.

Reset password

Generate a fresh password for one proxy — HTTP and SOCKS5 both switch within about a second. Use it when handing a proxy to a different end customer.

curl -X POST \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{"proxy_id": "1f6f2a34-...."}' \
  https://whitecloakproxy.com/api/reseller/v1/proxies/reset-password

{
  "success": true,
  "proxy_id": "1f6f2a34-....",
  "password": "nEw9pAsS2q"
}