All requests require a Bearer token in the Authorization header:
\nAuthorization: Bearer lux-YOUR_API_TOKEN\nProduction:
\nhttps://api.luxana.my\nNote: All endpoints automatically include /custom-api prefix.
POST /v1/orders
Create a new order in the Luxana system.
\n[\n \"cod\", // Cash on Delivery\n \"cash\", // Cash payment\n \"bank_transfer\", // Bank transfer\n \"billplz\", // Billplz gateway\n \"bizappay\", // BizAppay gateway\n \"chip\", // Chip payment\n \"chip_qr\", // Chip QR code\n \"chip_atome\", // Chip Atome\n \"chip_wallet\", // Chip Wallet\n \"chip_cc\", // Chip Credit Card\n \"toyyibpay\", // ToyyibPay gateway\n \"stripe\", // Stripe\n \"foc\" // Free of Charge\n]\n[\n \"ninjavan\", // Ninja Van\n \"posmalaysia\", // Pos Malaysia\n \"jnt\", // J&T Express\n \"dhl\", // DHL\n \"aramex\", // Aramex\n \"redlyexpress\", // Redly Express\n \"self_pickup\" // Self Pickup\n]\nAccepts full name or code:
\n[\n \"MY\", // Malaysia (default)\n \"SG\", // Singapore\n \"BN\" // Brunei\n]\nCurrency is automatically determined by the country field and converted based on your company's currency rate settings.
Each item must have:
\nExample:
\n\"items\": [\n { \"sku\": \"VA1\", \"quantity\": 2 },\n { \"sku\": \"IM1\", \"quantity\": 1 }\n]\nNotes:
\n{\n \"success\": true,\n \"message\": \"Order created successfully\",\n \"provider\": \"Luxana API v1\",\n \"data\": {\n \"order_id\": 141600,\n \"status\": \"new\",\n \"selling_price\": 150,\n \"foreign_selling_price\": null,\n \"currency\": \"MYR\",\n \"exchange_rate_used\": 1,\n \"created_at\": \"2025-10-31T08:12:05.803Z\",\n \"source_order_id\": \"YOUR-ORDER-123\"\n }\n}\n400 Bad Request - Missing/invalid fields:
\n{\n \"success\": false,\n \"error\": \"Missing required fields: name, phone, address, postcode, city, state, country\"\n}\n400 Bad Request - Invalid SKU:
\n{\n \"success\": false,\n \"error\": \"Item validation failed\",\n \"message\": \"SKU \\\"INVALID\\\" not found in products or bundles\"\n}\n401 Unauthorized - Invalid/missing token:
\n{\n \"success\": false,\n \"error\": \"Invalid or expired token\"\n}\n403 Forbidden - Insufficient permissions:
\n{\n \"success\": false,\n \"error\": \"Insufficient permissions\",\n \"message\": \"This API key does not have \\\"orders:write\\\" permission\"\n}\n429 Too Many Requests - Rate limit exceeded:
\n{\n \"success\": false,\n \"error\": \"Rate limit exceeded (per minute)\",\n \"retry_after\": 45\n}\n500 Internal Server Error - Server error:
\n{\n \"success\": false,\n \"error\": \"Failed to create order\",\n \"message\": \"Error details...\"\n}\nMYR60 prefixSGD → converted to MYRBND → converted to MYRcountry field (MY→MYR, SG→SGD, BN→BND)selling_price - shipping_cost - cod_costnew statuslux-)Use the health check endpoint to verify API availability:
\nGET /v1/health
No authentication required.
\nResponse:
\n{\n \"success\": true,\n \"message\": \"Custom API is running\",\n \"version\": \"1.0.0\",\n \"timestamp\": \"2025-10-31T08:12:05.803Z\"\n}\nCheck if the API is running. No authentication required.
\nNo authentication required
\nResponse:
\n{\n \"success\": true,\n \"message\": \"Custom API is running\",\n \"version\": \"1.0.0\",\n \"timestamp\": \"2025-10-31T08:12:05.803Z\"\n}\nThis example shows the minimum required fields to create an order.
\nname - Customer namephone - Customer phone (will be auto-formatted for MY)address - Street addresspostcode - Postal codecity - City namestate - State (full name or code like \"SGR\")country - Country code (\"MY\", \"SG\", \"BN\")items - Array with at least 1 item (sku + quantity)selling_price - Total order pricecodninjavanMYR (determined by country)This example includes all available fields (required + optional).
\nname, phone, address, postcode, city, state, countryitems (array), selling_priceemail - Customer emailaddress_2 - Additional address linepayment_method - See enum list in collection docsshipping_method - See enum list in collection docsshipping_cost - Override auto-calculationcod_cost - Override auto-calculationawb_note - Note for courier/airway billprivate_note - Internal note (not shown to customer)source_order_id - Your external system's order referencetransaction_id - Payment gateway transaction IDNOT included - Currency is auto-determined by country field:
Each item requires:
\nsku - Must exist in your product catalogquantity - Must be > 0Supports both regular products and bundles.
\n","urlObject":{"path":["custom-api","v1","orders"],"host":["https://api.luxana.my"],"query":[],"variable":[]}},"response":[],"_postman_id":"e8beca15-4f91-4a8a-91c8-cb900709568b"},{"name":"Create Order - Singapore","id":"e565fb7d-4f93-4ef0-abcc-4a4a443718b8","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Authorization","value":"Bearer lux-YOUR_API_TOKEN_HERE","type":"text"},{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n \"name\": \"Jane Tan\",\n \"phone\": \"91234567\",\n \"address\": \"10 Orchard Road\",\n \"postcode\": \"238841\",\n \"city\": \"Singapore\",\n \"state\": \"Singapore\",\n \"country\": \"SG\",\n \"items\": [\n {\n \"sku\": \"VA1\",\n \"quantity\": 1\n }\n ],\n \"selling_price\": 50.00\n}"},"url":"https://api.luxana.my/custom-api/v1/orders","description":"Country: SG
Auto-Defaults:
\ncod)ninjavan)SGD (auto-detected from country)Currency Conversion:
\nselling_price: 50.00 with country: SGResponse:
\n{\n \"success\": true,\n \"provider\": \"Luxana API v1\",\n \"data\": {\n \"order_id\": 141601,\n \"selling_price\": 175,\n \"foreign_selling_price\": 50,\n \"currency\": \"SGD\",\n \"exchange_rate_used\": 3.5\n }\n}\n⚠️ Important:
\ncurrency field - it's auto-determined from countryselling_price should be in the local currency (SGD for Singapore)You can include:
\n\"items\": [\n { \"sku\": \"VA1\", \"quantity\": 3 }, // 3x Product VA1\n { \"sku\": \"IM1\", \"quantity\": 2 }, // 2x Product IM1 \n { \"sku\": \"BUNDLE-01\", \"quantity\": 1 } // 1x Bundle\n]\nSKU Validation
\nBundles
\nStock
\nPricing
\nselling_price should be your total (including all items)