Integration Guide for Sellers Using Third-Party Enablers

Registration & Operation
This article will guide you through the integration process between Tokopedia and TikTok Shop by Tokopedia. It covers the essential actions you need to take to complete the integration with your third-party enabler, ensuring a smooth transition and seamless seller experience.
Two groups of sellers will be affected:
  • Sellers using third-party enablers: Those using third-party apps via the Tokopedia Open Platform or TikTok Shop Partner Centre.
  • Seller Developers: Sellers who develop their own apps and APIs to facilitate their shop operations.
image

Integration Guide for Sellers Using Third-Party Enablers

For sellers using third-party enablers, the integration process requires confirming that their third-party enabler providers have updated their applications and APIs to the latest version. This is critical to ensure seamless compatibility with the new Tokopedia & TikTok Shop platform. Sellers should proactively verify with their third-party enabler providers to avoid any disruptions. If a third-party enabler's application is not updated in time, the seller's account will not be considered integration-ready, potentially impacting their operations during the transition period.

Actions Required if Your Enabler Is Not Ready

If the third-party enabler is not yet prepared for integration but the seller is already included in the batch rollout schedule, several solutions are available to mitigate disruptions:
  1. Solution 1: Using the Seller Centre Platform Directly Sellers can continue managing their store operations, such as product and order management, through the new Seller Centre independently. This allows them to maintain core functionality while waiting for their third-party enabler to complete the necessary updates.
  2. Solution 2: Postponing the Shop Binding or Merging Process Sellers have the option to delay the binding of their shop until their third-party enabler has fully adopted the new API. This approach ensures that the binding process is performed seamlessly without risking errors or partial integration.
  3. Solution 3: Switching to a Stable Third-Party Enabler Temporarily Sellers can consider transitioning to alternative third-party services or enablers that have already adopted the latest functionality and are stable. Each of these third-party enablers has been confirmed to support the updated APIs and can serve as a temporary solution to maintain operations during the interim.
image

Integration Guide for Seller Developers

Seller developers, responsible for their own apps and APIs, must prepare for integration by binding their accounts and apps across Tokopedia and TikTok Shop and upgrading to the latest API version. This ensures compatibility with the new platform and continued access to its features. Unlike sellers using third-party enablers, who rely on providers for their technological needs, seller developers bear the direct responsibility of making their systems compatible with the updated platform.

Steps for Seller Developers

To prepare for integration and maintain uninterrupted operations, seller developers need to undertake several key actions:
  1. Bind Accounts: Link developer accounts on both platforms via TikTok Shop Partner Center > My account > Link Tokopedia Account. Note: Account binding is one-to-one.
  2. Bind Apps: Link Tokopedia Open Platform apps with TikTok Shop Partner Centre apps. Multiple Tokopedia apps can link to a single TikTok Shop app.
  3. Integrate APIs: Integrate with TikTok Shop APIs for seller operations. After integration:
    • All newly generated data will only be accessible via TikTok Shop APIs.
    • Some historical data (e.g., seller profiles) will be migrated, while others (e.g., orders, bills) will remain in Tokopedia.
image

FAQs

General

  1. What resources are available to help with the API integration and migration?
Sellers and developers can refer to API documentation and API one-pager guideline. For further assistance, we provide an on-call session with the seller if needed. Please fill out the following form first, and our team will schedule the meeting accordingly Shop | Tokopedia API Migration On-Call Request
  1. What happens if my third-party enabler's API is not updated by the rollout phase?
If your third-party enabler's API is not updated, you will still be able to manage your store operations using the TikTok Shop Seller Center directly. However, some functionalities—such as automatic inventory synchronisation and real-time order processing—will not work until the enabler completes the update. To avoid disruptions, monitor your enabler's progress and ensure your operations are prepared to transition to the Seller Centre temporarily.
  1. How can I confirm that my third-party enabler supports the latest API version?
Sellers can check the status of their enabler's integration by referring to the Toko x TTS Partner Migration Mastersheet, which provides real-time updates on integration progress. Alternatively, contact your enabler directly for confirmation.
  1. How can I check which third-party enablers are connected to my Tokopedia seller account?
To see the third-party enablers currently linked to your Tokopedia seller account, follow these steps:
  • Log in to Tokopedia Seller Center.
  • Click on Settings (Pengaturan) in the left sidebar.
  • Select Third-Party Applications (Aplikasi Pihak Ketiga).
  • You will see a list of third-party enablers that have access to your store with their authorisation status (Active/Inactive).
    image
    1. How do I check which third-party enablers are connected to my TikTok Shop account?
    To check third-party enablers connected to TikTok Shop:
    • Log in to TikTok Shop Seller Center.
    • Navigate to App Store in the left sidebar.
    • Click on My Apps and Incidents (top right corner).
    • Under the Apps tab, you will see the enablers authorised for your shop.
      image
      image
      1. Why do some third-party enablers appear in Tokopedia but not in TikTok Shop (or vice versa)?
      Not all enablers support both platforms. Some are integrated only with Tokopedia, while others work with TikTok Shop. You can check third-party enabler compatibility in their service descriptions.
      1. Can I switch to a different third-party enabler during the integration period?
      Yes, sellers can transition to another enabler from the list of confirmed providers that have successfully integrated with the new API. Ensure the new enabler meets your operational needs before switching.
      1. Can I begin API updates even if my shop is not included in whitelist phases?
      Yes. Developers can start binding accounts and updating APIs immediately, ensuring smooth integration when the shop becomes eligible.

      Product & Inventory

      1. How can I identify whether a product belongs to Tokopedia or TikTok Shop in my third-party enabler app?
      Most enablers display platform identifiers (e.g., "Tokopedia" or "TikTok Shop") next to products or orders. Ensure your enabler has updated these labels post-integration. If unavailable, contact your enabler to add this feature.
      1. Why are my products unexpectedly active/inactive?
      This may occur if the enabler hasn't aligned its sync logic with the new API. Report this to your enabler immediately. Meanwhile, disable automatic inventory updates in the enabler's settings and manage listings manually in the Seller Centre.
      image
      1. How can I resolve duplicate products/SKUs after migration?
      Sellers have two options:
      • Merge Products/SKUs Manually: This combines duplicate records into a single SKU while preserving inventory and sales history. This can be done in the Seller Centre or during the shop binding process.
      • Delete Duplicate Products/SKUs: If merging isn't feasible, manually delete duplicate records via the Seller Centre or an enabler app. Ensure the correct SKU is deleted to avoid data loss.

        Order & Aftersales

        1. How are orders differentiated between platforms in the third-party enabler interface?
        Orders are typically tagged with platform-specific metadata, such as a platform name or logo. Updated enablers provide filters or grouping options to sort orders by platform.
        image
        1. What if my orders do not sync properly after integration?
        This usually indicates incomplete API integration. Contact your enabler for support. While waiting, manage orders directly in the Seller Centre.
        1. Can sellers still process returns and refunds through their third-party enabler platform?
        Returns and refunds can be processed via the enabler only if it supports the new API. If not, manage them in the Seller Centre until full integration is complete.

        Authorization & App Store

        1. Will my previously used apps on Tokopedia automatically reconnect?
        No, previously used apps won't reconnect automatically. However, the system has been designed to assist sellers during shop binding process by providing recommendations for apps previously linked to their Tokopedia account. These recommendations are displayed in the app store within the Seller Center. Sellers can select and reconnect their preferred apps with a few clicks, ensuring a smooth transition without having to manually search for or reconfigure each app.
        1. If I use multiple third-party enablers and my shop is integrated with both Tokopedia and TikTok Shop, will my data sync automatically across enablers?
        No, data from two separate third-party enablers will not automatically sync across platforms. Each enabler operates independently based on its own integration with the seller's account. If both enablers are managing the same shop on different platforms, they will only have access to the data permitted through their respective API connections. Sellers need to ensure that each third-party enabler is correctly configured to avoid data inconsistencies, such as duplicate product listings or mismatched inventory levels.
        1. Can one third-party enabler access data from another if my shop is integrated?
        No, one third-party enabler does not have access to another enabler's data unless explicitly granted by the seller. Enabler A can only access the data assigned to it through its API authorization. The same applies to enabler B. Even if the shop is integrated across platforms, each enabler operates in isolation and does not automatically share data with the other.
        1. Can I test the new API before switching?
        Yes, TikTok Shop Partner Center provides a sandbox environment where sellers and developers can test the new API features before full implementation. This allows sellers to familiarise themselves with the updated functionality, test for potential issues, and make adjustments to their workflows before officially transitioning. https://partner.tiktokshop.com/docv2/page/678a23139c908d0304337d91#Back%20To%20Top