TikTok Shop is live in more and more European markets, and store owners keep asking how to sell there without retyping their catalogue. If your store runs on PrestaShop 8 or 9, you do not need a separate catalogue or two order panels. In this article I describe how the PrestaShop–TikTok Shop integration works through the official API, what the implementation looks like step by step, where stores most often get stuck, and what it costs.
The text is based on an implementation in a live fashion store with thousands of variants and on conversations with store owners who tried to enter TikTok Shop by hand. If you only need the list of requirements, see the separate 10-point TikTok Shop requirements checklist for a PrestaShop store.
What TikTok Shop is and why it is worth being there
TikTok Shop is a store built into the TikTok app. The customer sees a product in a video, a LIVE stream or a creator profile and buys it without leaving the app. For a store it means a new sales channel with its own cart, payments and orders that have to be connected to your warehouse and logistics. Listing products by hand makes sense for a handful of items. With several hundred, with size and colour variants, it does not work without an integration.
The biggest difference between TikTok Shop and a classic marketplace: the customer does not search for the product, they discover it. A store with a tidy catalogue that reacts quickly to orders beats a bigger competitor who lists by hand.
How the PrestaShop TikTok Shop integration works
The PrestaShop TikTok Shop module (RB TikTok Shop Pro) connects your store to your seller account through the TikTok Shop Open API (version 202309 and newer). All the work happens in the PrestaShop back office, in a TikTok Shop section with 14 screens: from the dashboard and OAuth connection, through products, category and attribute mapping, prices and stock, to orders, webhooks, the queue, logs and diagnostics.
Connecting to the seller account
Setup does not require a developer. You enter your app details from TikTok Shop Partner Center, click “Connect to TikTok Shop” and authorise the store. The module fetches the shop ID, region and shop cipher on its own and refreshes tokens automatically before every API call. An integrator can generate a one-time authorisation link valid for 48 hours and send it to the store owner, who approves access from their own account. There is also a sandbox environment for testing.
Product export with variants and images
The Products screen shows the whole catalogue with its TikTok Shop status, TikTok product ID, last sync date and last error. PrestaShop combinations become TikTok variants (up to three attribute groups, with reference and EAN), images are uploaded once and again only after the file is replaced, and weight and dimensions come from product data with support for store units. A product that already exists in TikTok Shop is updated rather than duplicated. Up to ten selected products are sent immediately with a result for each; larger batches go through the background queue. Before sending you can preview the data (dry run).
Categories, attributes, certificates and GPSR
TikTok requires every product to be assigned to a category from its own tree and to have the mandatory attributes filled in. The module downloads the TikTok category tree, maps PrestaShop categories with AI suggestions, fetches the list of attributes and allowed values, matches them from product features and lets you set a default value per category. Certificates and size charts are added once per category, and GPSR data (manufacturer and EU responsible person) is fetched from your Seller Center and attached to every export. Pre-flight validation stops the export with a link to the screen where you can fill in the gaps.
Prices and stock
Every stock, price or specific-price change in PrestaShop goes into the queue and is pushed to TikTok Shop. For the TikTok channel you set a separate pricing policy: a percentage or fixed mark-up, rounding, and optional inclusion of specific prices. A stock buffer lets you show fewer units on TikTok than you have, so you never sell the same item in two channels. A full sync can be run on demand or on a schedule.
Orders, statuses and shipping in both directions
Orders are fetched via webhook and cron, or manually from a chosen date. Each becomes a full PrestaShop order, visible in the order list, in reports and in your ERP. The module waits until TikTok releases the order for fulfilment, so orders cancelled within the cancellation window never reach the store. Products are matched by SKU, the order gets the selected carrier and the shipping cost from TikTok, and the customer lands on a shared technical account, as a guest, or on an account with their real e-mail address (after uploading a CSV export from Seller Center). When you add a tracking number, the module passes it to TikTok; cancellations and returns come back to the store through webhooks. You map carriers, the hand-over method and statuses in both directions.
AI assistant and reliability
The optional AI assistant (any OpenAI-compatible provider, your API key stored encrypted) matches categories, suggests attribute mapping, generates titles and descriptions for TikTok Shop, audits catalogue readiness and explains API errors in plain language with a suggestion of what to fix. It never overwrites data without your consent, and a monthly request limit protects you from costs. Underneath runs a prioritised task queue, automatic retries on API limits, secure webhooks with signature verification, cron via CLI or a secret URL, logs with data masking and AES-256-GCM token encryption.
Implementation step by step
- Account and app. A seller account in TikTok Shop Seller Center and an app in Partner Center with product, order and logistics permissions. The module documentation describes step by step which permissions to enable and which URLs to enter.
- Installation and connection. Install the module on PrestaShop 8.x or 9.x, enter the app details, authorise via OAuth, test the connection and permissions on the diagnostics screen.
- Catalogue housekeeping. SKUs on products and combinations, weights and dimensions, product features from which the module derives attributes. This is the stage where gaps in store data usually surface.
- Mapping. Categories, attributes, attribute groups, certificates, GPSR and carriers. With the AI assistant it takes hours instead of days.
- Test export. Data preview (dry run), export of a few products, a check of TikTok moderation, corrections, then the whole catalogue through the queue.
- Orders. Carrier, customer mode, statuses and webhooks, a test import from a chosen date in silent mode, then go-live.
The most common problems with a TikTok Shop integration
From client implementations, three things take the most time: matching categories and attributes to TikTok’s requirements, the GPSR data required in the EU, and rejected listings whose reason is described only in a terse API message. That is why the module has AI category suggestions, GPSR fields carried over from Seller Center and logs with translated errors. Instead of checking every product by hand, you see a list of rejected listings with a concrete reason and a link to the place where you can fix it.
The fourth problem is buyer e-mail addresses. TikTok returns masked addresses through the API. If you want real addresses in your store, you need a CSV export from Seller Center and a tool that assigns them to orders. In the module it is one click with a preview of the changes.
Who the integration is for
- Fashion, beauty, lifestyle and accessories stores whose products sell well through video and creator collaborations.
- Stores with a large number of variants, where manual listing is unrealistic.
- Companies running an ERP or warehouse system connected to PrestaShop: TikTok orders flow through the same path as all others.
- Agencies and integrators managing client stores, thanks to the owner authorisation link and multistore with a separate connection per shop.
When the integration is not worth it
If you have a dozen products without variants and no plans to grow the catalogue, listing them by hand in Seller Center takes one afternoon and you do not need a module. The integration starts to pay off when stock and prices change more than once a week, when you handle orders in an ERP, or when the catalogue has more than a few dozen items. Then every day of manual synchronisation costs more than the licence.
How much a PrestaShop–TikTok Shop integration costs
The RB TikTok Shop Pro module includes the licence and support during configuration; the current price in EUR is shown on the product page and payment is via PayPal. If your store has unusual attributes, its own warehouse system or an ERP, I adapt the integration as part of PrestaShop support. Selling on InPost Merchant as well? Both channels run from one back office, because the InPost Merchant module for PrestaShop works on the same principle.
Frequently asked questions
Do I need a TikTok Shop account?
Yes. The module connects PrestaShop to an existing TikTok Shop seller account. You also need an app in TikTok Shop Partner Center.
Can TikTok prices differ from my store prices?
Yes. You set a percentage or fixed mark-up, rounding, and decide whether to include specific prices.
Does the module work with multistore?
Yes. Each shop can have its own TikTok Shop connection, mappings and settings.
Is the AI required?
No. The AI assistant is optional and only works after you enter your own API key. The whole integration works without it.
What are the technical requirements?
PrestaShop 8.0–8.2.x or 9.x, PHP 7.4–8.3 with the curl and openssl extensions, and a cron job for the queue. No Composer on the server and no core file modifications. The module back office is available in English and Polish.
Questions about a TikTok Shop integration? Write to me, I reply within one business day.
