Get started with Shopee on HexaSync

Q: Should I choose Worldwide or China when I connect a store?

Choose Worldwide for stores in Vietnam and the other markets in the Worldwide group. Choose China if the store belongs to the China region. When you re-authorize, choose the same region you used the first time, as in Step 4.

Q: Where do I get the Partner ID, Partner Key and Push Partner Key?

In Shopee Open Platform, open App Management › App List and select the Shopee App to get the Partner ID and Partner Key. To get the Push Partner Key, open App Management › Push Mechanism › Set Push. If you connect Production, use the matching Live details. For details, see Part 3 of the guide to creating a Shopee App.

This guide is for business owners who run a Shopee store and for developers who are asked to set up the connection. You will connect your Shopee store to HexaSync Automation Engine, create a Shopee Connector, and optionally configure a webhook to receive events in real time.

Before you start

A Beehexa account to sign in to HexaSync Automation Engine. If you do not have one yet, sign up on the same page.
The Shopee Seller Center account of the owner of the store you want to connect. The business owner can work with a developer on the app configuration steps.
The store region: Worldwide (includes Vietnam) or China.
If you use your own Shopee App: the Partner ID, Partner Key and Push Partner Key for the right connection environment. If you have not created the App yet, follow the guide to create a Shopee App on Shopee Open Platform Console before you continue.

Note: For the Production environment, the Shopee App must have the Online status. A developer can prepare the app and the connection details, and the store owner confirms the authorization on Shopee.

Part 1: Connect Shopee on HexaSync

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

Step 2: Start the Shopee connection

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

Step 3: Choose a Shopee App

Select Use a different app, then select I will provide my Shopee app.
On the Register a New Shopee App screen, enter the Partner ID, Partner Key and Push Partner Key.
In App Environment, select Production for Live details. Select Test only if the app belongs to the sandbox environment.
Check the values and select Continue.

HexaSync shows “Whitelist the HexaSync redirect URL in Shopee Open Platform”? Check the Authorization Information section of the Shopee App on Shopee Open Platform. The Redirect URL Domain must be entered exactly as:
https://app.hexasync.com/
Keep the / at the end of the address. For how to configure it, see Step 7 of the guide to creating a Shopee App.

Step 4: Choose the shop region

Select the Shop Region that matches the store: Worldwide or China.
Select Continue to Shopee.

Step 5: Authorize on Shopee

Sign in with the seller account of the store and select the correct country.
Check the permissions the app requests on Shopee, then select Confirm Authorization.
In Authorization Period, select 365 Days if it suits you, then select Confirm Authorization again.

Step 6: Save and configure the Webhook URL

On the Connected - Save Your HexaSync Webhook URL screen, copy and save the Webhook URL so you can set up real-time events.
In Shopee Open Platform, open App Management › Push Mechanism › Set Push.
Turn on Get Live Push and paste the Webhook URL into Live Call Back URL.
Select the Deployment Service Area, then select Verify.
Turn on the push codes you want to receive.

Note: Push is configured at the Shopee App level and applies to all stores authorized with the same app. The business owner can ask a developer to configure it if they do not manage Shopee Open Platform.

Step 7: Finish the setup on HexaSync

Continue to the step that creates the Shopee Connector on HexaSync and enter a name that is easy to recognize.
When it finishes, HexaSync shows Connection successful.

Part 2: Check the result after connecting

Open the Connector Apps list and select the Shopee Connector you just created.

Check the connection details

HexaSync showed Connection successful after it created the Shopee Connector.
In the Connector App you just created, go to Settings to see the Shopee connection details.

Check the Webhook URL

The Webhook URL from Step 6 is saved so you can configure real-time events when you need them.

Note: Authorizing the connection does not mean that a data sync process between Shopee and another system has been configured.

Part 3: Re-authorize the Shopee connection on HexaSync

Do this when the authorization period ends, the app is removed on Shopee, or HexaSync reports a token-related error.

Step 1: Open the connected app

Open the matching Shopee Connector in Connector Apps and select Settings.

Step 2: Select Re-authorize

In Settings, find the Shopee connection details and select Re-authorize.

Cannot run Re-authorize? Only the owner (the person who created the connection) can do this. Contact the owner of the Shopee connection.

Step 3: Confirm the Shopee App

On the Choose an app to connect to Shopee screen, the current app has the Selected label. Select Continue. If you need to choose another app, use Use a different app.

Step 4: Choose the shop region again

Select the same Shop Region as in the first authorization (Worldwide or China) and select Continue.

Step 5: Confirm the authorization on Shopee again

Sign in with the store owner account, select Confirm Authorization, choose the duration in Authorization Period and confirm again, as in Step 5 in Part 1.

Note: When you re-authorize the same store, the existing connection details are updated. You do not need to change the Webhook URL you already configured.

Part 4: Common errors and how to fix them

Message	How to fix it
The application has been registered but not belong to you (status 400)	Go back to Select an App and choose the registered app. If the app is not in the list, contact the admin who owns the app to get access.
error_wrong_region	Check and select the correct country of the store when you sign in to Shopee, then authorize again.
Shopee Rejected The Authorization Code	Start the authorization process again and complete the steps without stopping. The authorization code is valid only for a short time and can be used only once.

For other cases, send a screenshot of the error (with sensitive information hidden) to support@beehexa.com.

Part 5: Frequently asked questions

Should I choose Worldwide or China when I connect a store?

Choose Worldwide for stores in Vietnam and the other markets in the Worldwide group. Choose China if the store belongs to the China region. When you re-authorize, choose the same region you used the first time, as in Step 4.

Does a successful authorization mean the data is already synced with other systems?

No. Authorizing the Shopee connection with HexaSync is one setup step. The data sync process between Shopee and another system is a separate topic.

Where do I get the Partner ID, Partner Key and Push Partner Key?

In Shopee Open Platform, open App Management › App List and select the Shopee App to get the Partner ID and Partner Key. To get the Push Partner Key, open App Management › Push Mechanism › Set Push. If you connect Production, use the matching Live details. For details, see Part 3 of the guide to creating a Shopee App.

When do I need to re-authorize the Shopee connection?

When the Authorization Period expires, the store has removed the app in Shopee Seller Center, or HexaSync reports a token-related error. Open the existing Shopee Connector App and follow Part 3.

Who can run Re-authorize for the Shopee connection?

Only the owner (the person who created the connection) can select Re-authorize. If you are not the owner, contact the person who manages the connection to re-authorize it.

Does HexaSync write or change data on Shopee?

No. The Shopee Connector App only reads data. It does not write or change data on Shopee.