Order API
Send orders from your own website or app straight to our production team.
1. Get a key
Log in to the reseller portal, open the Integrations tab and create a key. It is shown once, so save it. Send it with every call:
Authorization: Bearer pod_live_xxxxxxxxxxxxxxxx
Only approved resellers can use the API. Limit: 120 calls per minute per key. Orders are paid from your wallet exactly like store orders.
2. List the products
curl https://cluesstyle.com/api/pod/v1/products \
-H "Authorization: Bearer pod_live_xxx"
Returns each product's id, basePrice, sizes and colors.
3. Upload the design
curl -X POST https://cluesstyle.com/api/pod/v1/designs \
-H "Authorization: Bearer pod_live_xxx" \
-F "file=@design.png"
# -> { "success": true, "url": "/api/pod/file/r12-abc123.png" }
4. Create the order
curl -X POST https://cluesstyle.com/api/pod/v1/orders \
-H "Authorization: Bearer pod_live_xxx" \
-H "Content-Type: application/json" \
-d '{
"productId": 1,
"designUrl": "/api/pod/file/r12-abc123.png",
"quantity": 1,
"size": "M",
"color": "Black",
"sellingPrice": 599,
"collectCod": true,
"externalRef": "SHOP-1001",
"customer": {
"name": "Asha Rao", "phone": "9876543210", "email": "asha@example.com",
"address": "12 MG Road, Indiranagar", "city": "Bengaluru", "state": "Karnataka", "pincode": "560038"
}
}'
# -> { "success": true, "orderRef": "POD-ABC123", "status": "new" }
| Field | Notes |
|---|---|
sellingPrice | Per piece. Must not be lower than the base price. |
collectCod | true (default): the courier collects sellingPrice × quantity. false: your customer already paid you. |
externalRef | Your own order number. Sending it again returns the first order (duplicate: true), so a retry never makes a second order. |
status | new = paid from the wallet. on_hold = the wallet was too low; add money and pay it in the portal. |
5. Check an order
curl https://cluesstyle.com/api/pod/v1/orders/POD-ABC123 \
-H "Authorization: Bearer pod_live_xxx"
# -> { "status": "shipped", "courier": "Delhivery", "trackingNo": "...", "paid": true }
Errors come as { "success": false, "error": "..." } with a normal HTTP status (400 wrong data, 401 bad key, 429 too many calls). Ready-made Shopify and WooCommerce connectors are not available yet; they can be built on this API.