Account Balance & Orders API

{
  "success": false,
  "error": "ZentisLabs sells to businesses only. Please confirm in your dashboard that you are buying as a business.",
  "code": "BUSINESS_CONFIRMATION_REQUIRED"
}

curl "https://api.zentislabs.com/api/v1/wallet" \
  -H "X-API-Key: YOUR_API_KEY"

{
  "success": true,
  "data": {
    "enabled": true,
    "balances": {
      "usd": { "cents": 4010, "formatted": "$40.10" },
      "eur": { "cents": 0, "formatted": "€0.00" }
    },
    "limits": {
      "topupMinCents": 500,
      "topupMaxCents": 200000,
      "balanceMaxCents": 1000000,
      "dailyApiSpendCapCents": 200000
    },
    "apiSpentTodayCents": { "usd": 5990, "eur": 0 }
  }
}

curl "https://api.zentislabs.com/api/v1/wallet/transactions?limit=25" \
  -H "X-API-Key: YOUR_API_KEY"

{
  "success": true,
  "data": [
    {
      "id": "8c1d0f4a-2b6e-4f3a-9d7c-5e2a1b0c9f84",
      "currency": "usd",
      "deltaCents": -5990,
      "balanceAfterCents": 4010,
      "kind": "purchase",
      "description": "Residential Basic 10 GB",
      "orderId": "3f2b6c1e-8d4a-4b7e-9a51-2c0e7f6d9b13",
      "createdAt": "2026-11-09T10:15:02.000Z"
    },
    {
      "id": "1a7e3c9b-5d2f-4e8a-b6c4-0f9d2e7a3b51",
      "currency": "usd",
      "deltaCents": 10000,
      "balanceAfterCents": 10000,
      "kind": "topup",
      "description": "Funds added (card)",
      "orderId": null,
      "createdAt": "2026-11-09T10:02:41.000Z"
    }
  ],
  "nextCursor": null
}

# Pay on a Stripe Checkout page
curl -X POST "https://api.zentislabs.com/api/v1/wallet/topup" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"amount": 100, "currency": "usd"}'

# Charge a saved card
curl -X POST "https://api.zentislabs.com/api/v1/wallet/topup" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"amount": 100, "currency": "usd", "paymentMethodId": "pm_XXXXXXXX"}'

// Checkout: open checkoutUrl in a browser to pay
{
  "success": true,
  "data": {
    "status": "checkout",
    "checkoutUrl": "https://checkout.stripe.com/c/pay/..."
  }
}

// Saved card charged, balance credited
{
  "success": true,
  "data": {
    "status": "succeeded",
    "creditedCents": 10000,
    "currency": "usd",
    "balance": { "cents": 10000, "formatted": "$100.00" }
  }
}

curl "https://api.zentislabs.com/api/v1/products"

// Abridged: light, advanced, mobile and datacenter follow in the same shape
{
  "success": true,
  "data": {
    "currencies": ["usd", "eur"],
    "products": [
      {
        "plan": "basic",
        "name": "Residential Basic",
        "unit": "GB",
        "purchasable": true,
        "availability": { "state": "AVAILABLE", "message": "" },
        "maxGb": 10000,
        "tiers": [
          { "minGb": 1,    "perGb": { "usd": 6.59, "eur": 5.931 } },
          { "minGb": 5,    "perGb": { "usd": 6.23, "eur": 5.607 } },
          { "minGb": 10,   "perGb": { "usd": 5.99, "eur": 5.391 } },
          { "minGb": 25,   "perGb": { "usd": 5.39, "eur": 4.851 } },
          { "minGb": 50,   "perGb": { "usd": 4.91, "eur": 4.419 } },
          { "minGb": 100,  "perGb": { "usd": 4.43, "eur": 3.987 } },
          { "minGb": 250,  "perGb": { "usd": 3.95, "eur": 3.555 } },
          { "minGb": 500,  "perGb": { "usd": 3.59, "eur": 3.231 } },
          { "minGb": 1000, "perGb": { "usd": 3.30, "eur": 2.97 } }
        ]
      }
    ],
    "note": "Prices are per GB before VAT. The per-GB price of the highest tier at or below the amount applies to the whole amount; amounts are rounded to 1 MB (0.001 GB). GET /api/v1/quote returns the exact total in cents."
  }
}

curl "https://api.zentislabs.com/api/v1/quote?plan=basic&gb=10&currency=usd"

{
  "success": true,
  "data": {
    "plan": "basic",
    "gb": 10,
    "currency": "usd",
    "perGb": 5.99,
    "totalCents": 5990,
    "formatted": "$59.90"
  }
}

// The same order in EUR: "perGb": 5.391, "totalCents": 5391, "formatted": "€53.91"

curl -X POST "https://api.zentislabs.com/api/v1/orders" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: 6f1c2a9e-4b7d-4e3a-8c05-d2b9e1f7a634" \
  -d '{"plan": "basic", "gb": 10, "currency": "usd"}'

{
  "success": true,
  "data": {
    "orderId": "3f2b6c1e-8d4a-4b7e-9a51-2c0e7f6d9b13",
    "plan": "basic",
    "gb": 10,
    "chargedCents": 5990,
    "currency": "usd",
    "balanceAfter": { "cents": 4010, "formatted": "$40.10" },
    "status": "completed",
    "replayed": false
  }
}

curl "https://api.zentislabs.com/api/v1/orders/3f2b6c1e-8d4a-4b7e-9a51-2c0e7f6d9b13" \
  -H "X-API-Key: YOUR_API_KEY"

{
  "success": true,
  "data": {
    "orderId": "3f2b6c1e-8d4a-4b7e-9a51-2c0e7f6d9b13",
    "plan": "basic",
    "gb": 10,
    "chargedCents": 5990,
    "currency": "usd",
    "status": "completed",
    "paidVia": "wallet",
    "createdAt": "2026-11-09T10:15:02.000Z"
  }
}

import { randomUUID } from "node:crypto";

const API = "https://api.zentislabs.com/api/v1";
const key = randomUUID(); // one key per order

async function placeOrder(attempt = 0): Promise<any> {
  try {
    const res = await fetch(`${API}/orders`, {
      method: "POST",
      headers: {
        "X-API-Key": process.env.ZENTISLABS_API_KEY!,
        "Content-Type": "application/json",
        "Idempotency-Key": key,
      },
      body: JSON.stringify({ plan: "basic", gb: 10, currency: "usd" }),
    });
    if ([500, 503, 504].includes(res.status) && attempt < 4) throw new Error(`HTTP ${res.status}`);
    return await res.json();
  } catch (err) {
    if (attempt >= 4) throw err;
    await new Promise((r) => setTimeout(r, 2 ** attempt * 1000));
    return placeOrder(attempt + 1); // same key: never charged twice
  }
}

const result = await placeOrder();
console.log(result.success ? result.data : `${result.code}: ${result.error}`);

import time
import uuid
import requests

API = "https://api.zentislabs.com/api/v1"
HEADERS = {"X-API-Key": "YOUR_API_KEY"}
ORDER = {"plan": "basic", "gb": 10, "currency": "usd"}

# 1. Is the plan purchasable?
products = requests.get(f"{API}/products", headers=HEADERS, timeout=30).json()["data"]["products"]
plan = next(p for p in products if p["plan"] == ORDER["plan"])
if not plan["purchasable"]:
    raise SystemExit(plan["availability"]["message"])

# 2. Exact total, and does the balance cover it?
quote = requests.get(f"{API}/quote", headers=HEADERS, params=ORDER, timeout=30).json()["data"]
wallet = requests.get(f"{API}/wallet", headers=HEADERS, timeout=30).json()["data"]
if wallet["balances"][ORDER["currency"]]["cents"] < quote["totalCents"]:
    raise SystemExit(f"Balance too low for {quote['formatted']}")

# 3. Place the order. Retries reuse the same key, so it is charged at most once.
key = str(uuid.uuid4())
response = None
for attempt in range(5):
    try:
        response = requests.post(f"{API}/orders", json=ORDER, timeout=60,
                                 headers={**HEADERS, "Idempotency-Key": key})
        if response.status_code not in (500, 503, 504):
            break
    except requests.RequestException:
        pass
    time.sleep(2 ** attempt)

if response is None:
    raise SystemExit("No response; retry later with the same key")
result = response.json()
if not result["success"]:
    raise SystemExit(f"{response.status_code} {result.get('code')}: {result['error']}")
order = result["data"]
print("Order", order["orderId"], "paid", order["chargedCents"], "balance", order["balanceAfter"]["formatted"])

# 4. Later: check the order
status = requests.get(f"{API}/orders/{order['orderId']}", headers=HEADERS, timeout=30).json()["data"]["status"]
print("Status:", status)