← Back to EcomCentral
LAZADA OPEN PLATFORM (LazOP)

Lazada Setup Guide

Connect your Lazada seller account to EcomCentral using the Lazada Open Platform API with HMAC-SHA256 signed requests. Supports Singapore, Malaysia, Vietnam, Thailand, Philippines, and Indonesia.

Prerequisites

🔒 Lazada uses HMAC-SHA256 signed requests on every API call. The signature is computed automatically by EcomCentral — you only need to supply your app_key, app_secret, access_token, and region.

Getting Your API Credentials

  1. Go to open.lazada.com and sign in with your Lazada seller account
  2. Navigate to My Apps and click Create App
  3. Fill in the app name, description, and callback URL — then submit for review
  4. Once approved, copy your App Key and App Secret from the app details page
  5. Use the OAuth2 authorization flow to generate an Access Token for your seller account. The Lazada Open Platform provides a token generation tool in the developer console.
  6. Note your region code from the table below (e.g. SG for Singapore)
  7. In EcomCentral, add a new Lazada connection and enter the four credentials
  8. Click ⚡ Test — a successful test confirms your signature and token are valid
⚠️ Access tokens expire. Lazada access tokens have a limited lifetime (typically 30 days). Use the refresh token flow to obtain a new access token before expiry, then update the connection in EcomCentral.

Region Gateways

Select the region that matches your Lazada Seller Center account. Each region uses a different API gateway.

RegionCodeGateway URL
SingaporeSGhttps://api.lazada.sg/rest
MalaysiaMYhttps://api.lazada.com.my/rest
VietnamVNhttps://api.lazada.vn/rest
ThailandTHhttps://api.lazada.co.th/rest
PhilippinesPHhttps://api.lazada.com.ph/rest
IndonesiaIDhttps://api.lazada.co.id/rest
ℹ️ You can also enter a full gateway URL directly in the region field (e.g. https://api.lazada.sg/rest) if you need to override the default.

Credentials Reference

KeyRequiredDescriptionExample
app_key Required The App Key from your Lazada Open Platform developer console 123456
app_secret Required The App Secret (HMAC signing key) from the developer console — keep this private abc123def456…
access_token Required OAuth2 seller access token authorizing EcomCentral to act on behalf of your seller account 50000601a…
region Required Region code selecting the correct API gateway (see table above) SG
✅ Alternative key names accepted: appKey for app_key; appSecret for app_secret; token for access_token.

API Endpoints Used

OperationMethodEndpoint
Test connectionGET/orders/get with limit=1
List ordersGET/orders/get with limit, offset
Order detail (items)GET/order/items/get?order_id=X
List productsGET/products/get with filter=all, limit, offset
Product detail by SKUGET/products/get?filter=all&sku_seller_list=["SKU"]&limit=1
Mark Ready-to-ShipPOST/order/rts with order_item_ids, shipment_provider, tracking_number
Update stockPOST/product/price_quantity/update with XML payload
📦 Orders are item-scoped in Lazada. There is no single-order detail endpoint. EcomCentral calls /order/items/get to retrieve all items for an order ID, then uses the resulting order_item_ids when marking items ready-to-ship via /order/rts.
ℹ️ Stock updates use an XML payload. The /product/price_quantity/update endpoint requires a payload parameter containing an XML document. EcomCentral handles this XML encoding automatically — you only need to supply the seller_sku and new quantity.

Order Item Statuses

Lazada order statuses are set at the item level. The order-list endpoint returns a statuses array (one entry per item status variant present in the order).

StatusLabelMeaning
pending Pending Order placed but not yet paid or confirmed
unpaid Unpaid Awaiting payment from buyer
ready_to_ship Ready to Ship Seller has marked the item ready; awaiting carrier pickup
shipped Shipped Item has been picked up by the carrier
toconfirmreceive To Confirm Receive Delivered to buyer; awaiting confirmation
delivered Delivered Buyer confirmed receipt
closed Closed Order fully completed and settled
cancelled Cancelled Order cancelled by buyer or seller
returned Returned Item returned by the buyer
lost Lost Item confirmed lost during shipment

Supported Features

FeatureSupportedNotes
View orders (paginated)✅Order number, date, status (from statuses array), total + currency
View order detail✅Full item list via /order/items/get: name, SKU, price, status, tracking
Add tracking / Ready-to-Ship✅Carrier + tracking number required; EcomCentral resolves order_item_ids automatically
View products (paginated)✅Item ID, SellerSku, name, price, stock quantity
View product detail✅Attributes (name, description), full SKU list with price/qty/status
Update stock quantity✅By SellerSku via XML payload to /product/price_quantity/update
Test connection✅Validates app_key, app_secret, access_token and region in one signed request

Troubleshooting

✕ Sign error / "Invalid signature"

The app_secret is incorrect or does not match the app_key. Double-check both values in your Lazada Open Platform developer console. EcomCentral computes the HMAC-SHA256 signature automatically — a sign error always means a credential mismatch.

✕ Error code 27 / "Invalid access token"

The access_token has expired or been revoked. Lazada access tokens expire after approximately 30 days. Use the OAuth2 refresh token flow in the Lazada Open Platform to obtain a new access token, then update the connection in EcomCentral.

✕ Wrong region / "API not found" or unexpected 404

Ensure the region code matches the Seller Center account's country. A Singapore seller account must use SG / https://api.lazada.sg/rest; sending requests to the wrong gateway returns errors even with valid credentials.

✕ Ready-to-Ship fails with "No order items found"

EcomCentral calls /order/items/get first to resolve item IDs. If the order has no eligible items (e.g. already shipped or cancelled), the RTS call cannot proceed. Verify the order status in Lazada Seller Center before retrying.

✕ Product detail returns empty

The sku_seller_list filter on /products/get is case-sensitive and must exactly match the SellerSku registered in your Lazada listing. Verify the SKU in Seller Center under Products → Manage Products.