DEVELOPER RESOURCE

WhatBiz Supplier API

Integrate the WhatBiz product catalogue and create orders using your existing WhatBiz Bot Wallet. This page contains the public integration reference; API keys and wallet funds remain private to each reseller.

Base URL

https://whatbiz-singapore-test.onrender.com

All paths below are relative to this host. Use HTTPS in production. The public discovery endpoint is /api/v1.

Access required: Request an API key from WhatBiz support/admin. Keys are private, can be revoked, and must never be placed in browser-side code or public repositories.

Authentication

Send your API key with every protected request using either the X-API-Key header or a Bearer token.

X-API-Key: YOUR_API_KEY
# Or:
Authorization: Bearer YOUR_API_KEY

Endpoints

The API returns JSON. All endpoints except GET /api/v1 require authentication.

GET

/api/v1

Public API information, supported endpoints and limits.

GET

/api/v1/products

List currently available products with current WhatBiz customer prices.

GET

/api/v1/wallet

Read your existing WhatBiz Bot Wallet balance and recent transactions.

GET

/api/v1/orders?page=1&limit=20

List orders created with your API key. Limit can be 1–50.

GET

/api/v1/orders/{id}

Read an order you created and its current delivery status.

POST

/api/v1/orders

Purchase one product using your WhatBiz Bot Wallet balance.

Example: list products

curl 'https://whatbiz-singapore-test.onrender.com/api/v1/products' \
  -H 'X-API-Key: YOUR_API_KEY'

Product entries include an ID, source, name, current price in USD and LKR, availability, stock when supplied, and any required customer fields.

Example: create an order

Use a new unique Idempotency-Key for each purchase. It prevents accidental duplicate orders if a request is retried. Supported sources are qamify, vexoran, canboso, and own. Quantity is currently one product per request.

curl -X POST 'https://whatbiz-singapore-test.onrender.com/api/v1/orders' \
  -H 'Content-Type: application/json' \
  -H 'X-API-Key: YOUR_API_KEY' \
  -H 'Idempotency-Key: order-20261013-0001' \
  -d '{
    "source": "qamify",
    "productId": "PRODUCT_ID",
    "customerEmail": "customer@example.com",
    "customerData": {}
  }'

A successful response includes the order and wallet details. Product prices use the current WhatBiz store price and active offers; there is no separate API wholesale price.

Order status and wallet

The order response includes fields such as id, status, productName, priceUsd, createdAt, completedAt, deliveryItems, and instructions. Only orders created by your API key are visible to that key.

Purchases debit your existing WhatBiz Bot Wallet. Make sure the wallet has sufficient balance before ordering. An insufficient balance returns HTTP 402.

Rate limits

General requests: up to 120 requests per minute.
Order requests: up to 15 requests per minute.
Maximum supported quantity: 1 per order request.
When rate limited, the API returns HTTP 429 and may include a Retry-After header.

Common errors

HTTP	Meaning	What to do
400	Invalid request or missing required product fields.	Check source, productId, customer fields and Idempotency-Key.
401	API key missing, invalid or revoked.	Check your key and authentication header.
402	Insufficient wallet balance.	Top up your WhatBiz Bot Wallet before retrying.
404	Product unavailable or order not found.	Refresh the catalogue or verify the order ID.
409	Purchase already processing or idempotency conflict.	Wait, then retry with the same key only for the same request.
429	Rate limit reached.	Wait at least 60 seconds before retrying.
503	API or catalogue temporarily unavailable.	Retry later with sensible backoff.

Need an API key or help?

Contact support/admin to request API access, check wallet funding, or report integration issues. Never share your API key in public messages.

Contact support → · Return to store →

Documentation URL: https://novalicense.store/api-docs