Get started with Lazada on HexaSync

This guide shows you how to connect Lazada to HexaSync to get data from Lazada. The data is used to assess the quality of your product and inventory data and to check the data before you connect to another system.

Before you start

A Beehexa account to access HexaSync Automation Engine. If you do not have one yet, sign up on the same page.
The Lazada seller account that owns the shop you want to connect, which is the account you already use to sign in to Lazada Seller Center. It must be a single-country seller account, not a cross-border account.
Your business’s access to Lazada Open Platform, with an app that has an App Key and App Secret.

Note: Cross-border (CB) accounts are not supported yet. The Lazada Connector works only with single-country seller accounts (VN, TH, ID, MY, PH, SG…). A cross-border account is rejected at the authorization step.

Part 1: Authorize the Lazada connection on HexaSync

Go to HexaSync Automation Engine and sign in with your Beehexa account.

Step 2: Start the Lazada connection

Open the Lazada authentication page on HexaSync.
On the Check connection details screen, find Lazada and select Connect.

Step 3: Confirm the HexaSync app

If you registered the app before (for example when you connect a second seller account): on the app selection screen, select [App Key] Lazada Connector App and select Continue. You do not need to enter the details again. Go to Step 4.
If this is your first connection: follow the steps on the screen in order to enter the App Key and App Secret of your app on Lazada Open Platform.

You need two values from the app. Get them on Lazada Open Platform as follows:

Open Lazada Open Platform and sign in. The app management site is Lazada Service Provider Center.
On your first visit, complete the developer registration (company details, email verification) if you are asked to.

2. Create an app

In the left sidebar, open Development, then App Management, and select Create App.
Choose the App Category: to connect your own business’s shop, choose Seller In-house APP.
Fill in the basic details and submit.
Check that the app’s API Permission Group includes the Products permission.

3. Copy the App Key and App Secret

In App Management, select Manage on your app. The App Overview tab opens.
In the Advanced Information section on the right, copy the App Key (a string of digits).
Select View next to App Secret to show the key, then copy it.

Do not select Reset: this action changes the App Secret, and you then have to update the app in HexaSync.

4. Fill in the form on HexaSync

Go back to HexaSync and paste the values into the App Key and App Secret fields. Make sure the values are pasted exactly, with no extra spaces at the start or end.
Select Continue. HexaSync saves the app with the name [App Key] Lazada Connector App.

Security note: Keep the App Secret private like a password. Do not send it by chat or email. HexaSync stores this value encrypted and does not show it again.

Step 4: Register the Callback URL

For the app you just registered (an existing app or the app you created in Step 3), HexaSync shows the Register the HexaSync callback URL in Lazada Open Platform screen. This screen has a Callback URL that is specific to your app, in this form:

https://app.hexasync.com/credentials/callback/<app-id>

Copy the Callback URL on the HexaSync screen.
On Lazada Open Platform, open the app: Development → App Management → Manage → App Overview tab → Basic Information. Select Edit next to Callback URL.
Paste the URL you copied and select Save.
Go back to HexaSync and select I have registered the callback URL — continue.

Note: Lazada compares this URL character by character and refuses the authorization if it does not match.

Step 5: Authorize the app in Lazada

On the Redirecting You To Lazada screen, select Continue to Lazada.
Sign in to Lazada Seller Center with the seller account that owns the shop.
When asked, select the correct country or region of the shop.
On the authorization screen, check the access permissions the app requests, then select Authorize. Lazada automatically takes you back to HexaSync.

Step 6: Save the Webhook URL

When the authorization succeeds, HexaSync shows the Connected — Save Your HexaSync Webhook URL screen, with a Webhook URL that is specific to your app.

Copy the Webhook URL on the screen and save it in a safe place, for example a password manager or your team’s internal wiki. Do not paste the URL into a public chat group.
On Lazada Open Platform, open the app and go to the Push Mechanism tab.
Paste the Webhook URL into the Callback URL field, select the event types (event topic) you want to receive, then save.
Go back to HexaSync and select I have saved the webhook URL — continue.

Note: You need to set the Webhook URL only once for each app. The configuration applies to every seller account authorized through that app. Lazada uses the app’s App Secret to sign each delivery, and HexaSync rejects payloads with an invalid signature.

Step 7: Create the Lazada Connector

When Lazada shows the Connected status, select the button that creates the connector.
HexaSync names the connector automatically in the form [Seller account] Lazada Connector and creates it right away. You do not need to enter anything else. If the name already exists, HexaSync adds a sequence number, for example [Seller account] Lazada Connector (1).
Keep the page open for a few minutes. HexaSync creates the connector and then moves to the Tasks section of the Lazada Connector App when it finishes.

HexaSync turns on the sync schedule and gets the data for the first time right after the connector is created. You do not need to select Start.

Step 8: Check the Connector App on HexaSync

Check the connection details

Open the Lazada Connector App you just created in Connector Apps.
In Settings, confirm that Lazada has the Connected status.

Check the data

Open the Inventory task in the Connector App.
Compare some products and stock quantities with the data in Lazada.

Part 2: Re-authorize the Lazada connection on HexaSync

You need to re-authorize when:

The token expired and could not be refreshed automatically.
The shop revoked the app’s access.
HexaSync reports a connection error.

Step 1: Open the connector Settings

Open the Lazada Connector in Connector Apps and select Settings.

Step 2: Select Re-authorize

Find the Lazada row and select Re-authorize.

Cannot run Re-authorize? Only the person who created this connection can re-authorize it. Ask them to do this step.

Step 3: Confirm the app

The app in use is already selected (the Selected label), so you do not need to enter the app details again. Select Continue. If you want to use another app, select Use a different app.
If you have just changed the App Secret on Lazada Open Platform, select I will provide my Lazada app at this step and enter the correct App Key and the new App Secret again. HexaSync updates the existing app and does not create a new one.

Step 4: Confirm again on Lazada

Sign in to Seller Center with the same shop owner account you connected before, then select Authorize, as in Step 5 in Part 1.
HexaSync updates the existing connection details: it does not create a duplicate, and you do not need to change the Webhook URL you already configured.

Part 3: Check that the connection works

Step 1: Check that the connection details appear

Open the connector Settings. The Lazada row shows the connection details in place of the Authorize button.

Step 2: Check the inventory data

Open the connector Tasks page. After 15 to 30 minutes, the [Lazada] Product Sku Inventories task has data: each row is the inventory of one SKU.
The tasks do not report authorization errors.

Part 4: Common errors and how to fix them

Write down the message on the screen, then fix it by using the table below.

Message	Cause and how to fix it
HexaSync Could Not Register Your Lazada App	The app details are not correct. Check the App Key and App Secret again, then select Edit the app again.
The application has been registered but not belong to you	The App Key is already registered by another HexaSync account. Ask that person to share the app with you.
HexaSync Could Not Build Your Lazada Authorization Link	Select Choose another app and choose the app again, or check the app details again.
“Thiếu Tham số” (Missing parameter) / api.lazada.vn error page	Sign in to Lazada Seller Center first, then start the connection again.
client_id không hợp lệ (invalid client_id)	Check the App Key again in Part 1, Step 3.
You are not returned to HexaSync after you select Authorize	Repeat Part 1, Step 4 (Callback URL).
Lazada Did Not Return An Authorization Code	You did not select Authorize or you canceled on Lazada. Select Back to connection and try again.
Lazada Rejected The Authorization Code	The authorization code expired or was already used. Select Back to connection and authorize again.
HexaSync Could Not Verify The Stored Credential	Select Back to connection and authorize again.
Profile Quota Reached	The account has used all the connectors it is allowed. Contact support@beehexa.com to raise the limit.
Couldn’t Name Your Profile	You already have too many connectors with the same name for this seller account. Archive or rename some of them, then try again.

Check these first:

Sign in to Lazada Seller Center with the shop owner account before you select Continue to Lazada.

The Callback URL on the app matches the URL HexaSync shows, character by character.

Complete the whole process in one go, and do not close the page partway through.

Part 5: Frequently asked questions

Which Lazada account should I use to authorize the connection?

Use the seller account that owns the shop you want to connect, which is the account that signs in to Lazada Seller Center. Sign in to Seller Center before you start the authorization to avoid the Thiếu Tham số (Missing parameter) error.

Do I need to enter the App Key and App Secret again when I re-authorize?

No. Select the existing app and confirm again on Lazada. You need to enter the app details only when you switch to another app or have just changed the App Secret.

Does HexaSync write or change data on Lazada?

No. The Lazada Connector only reads data. It does not write back to Lazada.

Which data does HexaSync get from Lazada?

HexaSync gets the product list and inventory of the seller account, within the permissions you granted.

Can I rename the connector?

Yes. Open the Lazada Connector App in the Connector Apps list, select Settings, then select Change Name. Only the Owner of the Connector App can rename it.