Temu Integration for Magento — Setup Guide

1. Prerequisites

Before you begin, make sure your environment meets these requirements:

• Magento 2.4.x (Open Source or Adobe Commerce)
• PHP 8.1 or higher
• RabbitMQ (required for product, category, and attribute sync)
• Composer
• SSH or command-line access to your Magento server

2. Install the plugin

Choose your installation method:

Option A — Install from ZIP

If you downloaded the plugin ZIP from StichTech during onboarding:

1. Upload the ZIP file to your Magento server.
2. Extract the contents into your Magento installation's app/code/ directory. You should end up with two folders:
   • app/code/StichTech/TemuBase/
   • app/code/StichTech/TemuCatalog/
3. Continue to Step 3.

Option B — Install from Adobe Commerce Marketplace

If you downloaded the plugin from the Adobe Commerce Marketplace:

1. Get your Marketplace access keys at commercemarketplace.adobe.com/customer/accessKeys/. You will see (or generate) a Public Key and a Private Key.
2. Make sure your Magento project has an auth.json file in the root directory with your Marketplace credentials. If it doesn't exist, create it:

{
  "http-basic": {
    "repo.magento.com": {
      "username": "YOUR_PUBLIC_KEY",
      "password": "YOUR_PRIVATE_KEY"
    }
  }
}

Most existing Magento installations already have this file configured.

Run the following command from your Magento root directory:

composer require stich_tech/temu_catalog

This automatically pulls in the required dependency (stich_tech/module-temu-base). Continue to Step 3.

3. Enable the plugin and run setup

Run these commands from your Magento root directory, in this order:

bin/magento module:enable StichTech_TemuBase StichTech_TemuCatalog
bin/magento setup:upgrade
bin/magento setup:di:compile   # skip in developer mode
bin/magento cache:flush

After running these commands, the StichTech Temu Integration section will appear in your Magento Admin under Stores → Configuration.

4. Start the sync queue consumers

The plugin uses RabbitMQ for asynchronous sync. You need to start three queue consumers:

bin/magento queue:consumers:start temu.catalog.sync.categories &
bin/magento queue:consumers:start temu.catalog.sync.attributes &
bin/magento queue:consumers:start temu.catalog.sync.products &

5. Configure the plugin

In your Magento Admin, go to: Stores → Configuration → Stich-Tech → Temu Integration

General settings

• Enable Temu Integration — Set to Yes to activate the plugin.
• Connection Type — Choose Sandbox for testing or Production for live traffic.
• Region — Select the region that matches your Temu seller account:
  • US (Crossborder)
  • EU (Crossborder)
  • US (Local)
  • EU (Local)

API credentials

• App Key — From your Temu Seller Center → Developer settings.
• App Secret — From your Temu Seller Center → Developer settings. Stored encrypted.
• Access Token — Your OAuth access token from Temu Seller Center. Stored encrypted.

Where to find your Temu credentials

1. Log in to Temu Seller Center.
2. Navigate to Developer settings or Manage your apps.
3. Find the StichTech Connector for Magento app.
4. Click View access info.
5. Copy the App Key, App Secret, and Access Token.
6. Paste them into the corresponding fields in Magento.

Product sync settings

• Auto-Sync on Product Save — When set to Yes, products are automatically queued for sync every time you save a product with Temu sync enabled.
• Fulfillment Type — Choose Merchant Fulfillment (you ship) or Temu Fulfillment (Temu ships).
• Shipment Limit Days — Number of days you have to ship an order. Default is 3. Note: some Temu categories enforce stricter limits (1–2 days).
• Cost Template ID — Optional. If you've created a shipping cost template in Temu Seller Center, paste the template ID here.

About the Cost Template ID

The shipping cost template is created in Temu Seller Center. Example:

• Template: "EU Standard Shipping" — ID: 12345
• Germany: €3.99 (free over €30)
• France: €4.99 (free over €40)
• Spain: €5.99 (free over €50)
• Rest of EU: €7.99

Take the resulting Template ID and paste it into the Cost Template ID field in the Magento config. Click Save Config when done.

6. Verify your connection

Run the following command to test that your API credentials are working:

bin/magento stichtech:temu:test

If the test passes, your Magento store is connected to Temu. If it fails, double-check your App Key, App Secret, and Access Token in Step 5.

7. Sync Temu categories

Before you can list products on Temu, you need to import the Temu category tree into Magento.

From Magento Admin

Go to Stores → Configuration → Stich-Tech → Temu Integration → Category Sync, and click Sync Categories. Wait for the queue consumer to finish processing.

From the command line

bin/magento temu:sync:categories

Sync category attributes

After categories are imported, sync the category attributes. These define what information Temu requires for each product category:

bin/magento temu:sync:category-attributes --leaf-only

You only need to do this once, or whenever Temu publishes new categories.

Browse imported categories

You can view all imported Temu categories at Catalog → Temu Catalog → Temu Category Listing. This page shows a grid of every imported category with filters, columns, and CSV export. The toolbar also contains Sync Categories and Sync Attributes buttons so you can re-trigger sync without leaving the page.

8. List your first product on Temu

1. In Magento Admin, go to Catalog → Products and open any product.
2. Scroll down to the Sync to Temu section.
3. Set Enable Temu Sync to Yes.
4. In the Temu Category field, start typing — the autocomplete searches leaf categories and shows the full category path (e.g., Fashion > Women > Apparel > Shirts).
5. Click Save.

That's it. Your product is now queued and will be sent to Temu by the background consumer.

Product requirements

Before listing, make sure your product has:

• Recommended 3 images (maximum 10) — fewer than 3 are padded by duplicating the first image
• A price greater than €0
• A SKU
• A Temu category selected

Checking sync status

After sync, the following fields appear on the product page under Sync to Temu:

• Sync Status — pending (waiting to be sent), syncing (being sent now), synced (live on Temu), or error (something went wrong)
• Temu Goods ID — Temu's internal product ID, assigned after a successful sync
• Error Message — Only populated when sync status is "error"

Tips for product descriptions

Your Magento product description is sent to Temu as-is. Make sure it:

• Clearly describes the product
• Includes key features and specifications
• Mentions materials, dimensions, or sizes where relevant

9. Troubleshooting

composer show stich_tech/temu_catalog

bin/magento queue:consumers:list

10. Quick reference

11. CLI commands

All commands are run from the Magento root with bin/magento.