Social Commerce

Connecter TikTok Shop à un site sur mesure : guide API

Découvrez comment connecter TikTok Shop à un site sur mesure : données à synchroniser, OAuth, webhooks, polling et erreurs de mapping à éviter.

Photo de profil de Long Nguyen

Long Nguyen

Développeur fullstack · Ingénieur IA · Chercheur

• • 4 min de lecture •

Ce que signifie vraiment connecter TikTok Shop à un site sur mesure

TikTok Shop n’est pas un widget que vous intégrez à vos pages. Les acheteurs finalisent leur commande dans TikTok. « Connecter » votre propre site signifie donc synchroniser les données entre deux systèmes, et non intégrer un tunnel de paiement TikTok à vos pages. Une fois ce principe posé, le projet se divise en quatre flux de données, chacun avec ses propres risques d’erreur.

Flux Direction Données transférées Points de rupture
Catalogue Votre site vers TikTok Shop Produits, variantes, images, prix et attributs de catégorie Les règles de catégorie et les attributs obligatoires varient selon le marché ; les annonces refusées doivent générer une erreur visible
Stock Dans les deux sens Stock par SKU Risque de survente lorsque deux canaux vendent la dernière unité pendant la même fenêtre de synchronisation
Commandes De TikTok Shop vers votre site Nouvelles commandes, changements de statut, informations sur l’acheteur et la livraison Événements manqués ou dupliqués ; statuts qui ne correspondent pas à vos propres états de commande
Expédition Votre site vers TikTok Shop Numéros de suivi, transporteur, annulations et retours Transmission tardive du suivi pouvant dégrader vos indicateurs vendeur ; expéditions partielles

Déterminez lesquels de ces quatre flux vous sont réellement nécessaires avant d’écrire la moindre ligne de code. De nombreuses boutiques ont uniquement besoin de recevoir les commandes et de renvoyer les informations de suivi. Ne pas synchroniser le catalogue permet alors d’éliminer la partie la plus complexe du projet.

Trois façons de connecter TikTok Shop à votre site

Le bon choix dépend de la part de votre logique qui est standard et de celle qui vous est propre.

Approche À privilégier si Compromis
Connecteur ou application prête à l’emploi Votre site utilise une plateforme courante disposant déjà d’une intégration TikTok Shop La mise en place est rapide, mais vous acceptez son mapping des champs, son rythme de synchronisation et ses limites
Plateforme d’intégration (iPaaS) Vous avez besoin de quelques workflows et pouvez accepter une facturation mensuelle par tâche Les coûts augmentent avec le volume de commandes et les mappings complexes deviennent difficiles à gérer
Intégration personnalisée avec l’API TikTok Shop Partner Center Vous exploitez un site développé sur mesure, avez besoin de votre propre logique de commande ou synchronisez plusieurs canaux Le travail initial est plus important, mais vous gardez le contrôle sur le mapping, les nouvelles tentatives et la propriété des données

Si votre site est développé sur mesure, il n’existe généralement pas de connecteur prêt à l’emploi. C’est pourquoi la suite de ce guide se concentre sur la troisième approche.

Ce qu’il vous faut avant d’écrire du code

  • Un compte vendeur TikTok Shop approuvé pour chaque boutique que vous souhaitez connecter, sur le marché où vous vendez.
  • Une application développeur dans le TikTok Shop Partner Center. Vous créez l’application, choisissez les API scopes dont elle a besoin, puis obtenez une clé d’application et un secret d’application. Le type d’application adapté dépend du fait que vous connectiez uniquement votre propre boutique ou celles de plusieurs marchands. Les options actuelles sont détaillées dans le guide d’autorisation du Partner Center.
  • Un backend public en HTTPS capable de recevoir les redirections et les appels webhook. Un site statique ne peut pas s’en charger seul.
  • Un emplacement sécurisé pour les secrets : le secret de l’application et les tokens de chaque boutique doivent être stockés côté serveur, jamais dans le code front-end.

Les API scopes et la disponibilité selon les marchés évoluent. Consultez donc la liste des scopes dans le Partner Center au moment du développement, plutôt que de vous fier à un article de blog, y compris celui-ci.

Fonctionnement du parcours d’autorisation TikTok Shop

TikTok Shop utilise un parcours de type OAuth. Les concepts ci-dessous restent stables ; récupérez les URL exactes, les noms de paramètres et la durée de validité des tokens dans la documentation officielle.

  1. Redirigez le vendeur vers la page d’autorisation de TikTok pour votre application. Le vendeur se connecte et approuve les scopes demandés.
  2. TikTok redirige le vendeur vers votre URL de callback avec un code d’autorisation à courte durée de validité.
  3. Votre backend échange le code contre un access token et un refresh token, à l’aide de votre clé et de votre secret d’application. Cet appel doit être exécuté côté serveur.
  4. Identifiez la boutique autorisée et enregistrez ses identifiants avec les tokens. Les appels API au niveau de la boutique nécessitent un identifiant de boutique que TikTok renvoie pour cette autorisation. Enregistrez-le donc avec la fiche de la boutique.
  5. Renouvelez les tokens avant leur expiration. Les access tokens ont une durée de validité limitée. Une tâche planifiée doit donc les renouveler et enregistrer la nouvelle paire.

Chaque requête API est également signée avec le secret de votre application. Un simple client HTTP ne suffit donc pas : vous devez utiliser la routine de signature décrite dans la documentation officielle ou le SDK. Commencez par la valider dans un script de test, car les erreurs de signature sont la cause la plus fréquente d’échec du premier appel.

Conseils pratiques pour gérer les tokens

  • Les refresh tokens peuvent être renouvelés. Enregistrez la nouvelle valeur à chaque fois et ne la remplacez jamais par une copie obsolète provenant d’une tâche parallèle. Sérialisez les renouvellements par boutique à l’aide d’un verrou en base de données.
  • Chiffrez les tokens au repos et excluez-les des logs. Un token divulgué donne directement accès aux commandes et aux données client d’un marchand.
  • Prévoyez la révocation. Un vendeur peut révoquer l’accès à tout moment. Traitez un échec d’autorisation comme une « boutique déconnectée », suspendez sa synchronisation et affichez l’information dans votre interface d’administration au lieu de réessayer indéfiniment.

Une architecture backend capable d’absorber un vrai volume de commandes

Le modèle qui tient la charge est le même que pour la plupart des intégrations de marketplaces : des webhooks pour la rapidité, un polling planifié pour la fiabilité, une file d’attente entre les deux et des gestionnaires idempotents partout.

Composant Rôle Pourquoi c’est important
Service d’authentification Gère le callback, stocke et renouvelle les tokens de chaque boutique Un emplacement unique pour gérer les identifiants
Récepteur webhook Vérifie la signature, enregistre l’événement et renvoie rapidement une réponse positive Les traitements lents provoquent des timeouts et des nouvelles tentatives
File d’attente et workers Récupèrent les informations complètes sur les commandes ou les produits et mettent à jour votre base de données Le récepteur reste rapide et les nouvelles tentatives peuvent être effectuées en toute sécurité
Tâche de rapprochement Répertorie périodiquement les commandes récemment modifiées et les compare à vos données Permet de détecter les événements qui ne sont jamais arrivés
Journal de synchronisation Stocke chaque appel sortant et son résultat pour chaque boutique C’est le seul moyen de comprendre un mois plus tard pourquoi une commande est absente

TikTok Shop transmet les changements de commandes et de produits à un webhook que vous enregistrez. Les types d’événements, les champs des payloads et le comportement en cas de nouvelle tentative sont détaillés dans la documentation webhook du Partner Center. Quel que soit le calendrier des nouvelles tentatives, partez de deux faits : les événements peuvent arriver deux fois et certains peuvent être perdus.

Structure de base d’un récepteur webhook

La structure ci-dessous ne change pas d’une plateforme à l’autre. La vérification de signature et les noms de champs proviennent de la documentation officielle ; ils sont donc laissés sous forme de placeholders clairement signalés plutôt que devinés.

import json
from django.http import HttpResponse
from django.views.decorators.csrf import csrf_exempt
from django.db import IntegrityError
from .models import WebhookEvent
from .tasks import process_event


def signature_is_valid(request, raw_body):
    # Implement exactly as described in the Partner Center webhook docs.
    raise NotImplementedError


@csrf_exempt
def tiktok_webhook(request):
    raw_body = request.body
    if not signature_is_valid(request, raw_body):
        return HttpResponse(status=401)

    payload = json.loads(raw_body)
    event_key = payload.get("EVENT_ID_FIELD_FROM_DOCS")  # dedupe key

    try:
        # unique constraint on event_key makes duplicates harmless
        event = WebhookEvent.objects.create(event_key=event_key, body=payload)
    except IntegrityError:
        return HttpResponse(status=200)  # already seen

    process_event.delay(event.id)  # heavy work happens in a worker
    return HttpResponse(status=200)

Trois détails de cet exemple assurent l’essentiel de la fiabilité : vérifier la signature sur le corps brut avant de l’analyser, enregistrer d’abord puis traiter ensuite, et imposer l’unicité dans la base de données plutôt que dans le code applicatif.

Synchroniser correctement produits, commandes et stocks

La plupart des bugs d’intégration sont liés au mapping, et non à l’API. Voici les décisions à prendre volontairement.

Domaine Décision Recommandation
Identité du SKU Qu’est-ce qui relie votre produit à l’annonce TikTok Shop ? Stockez les identifiants produit et SKU de TikTok dans une table de correspondance ; ne vous fiez pas aux titres ni à une seule chaîne de SKU vendeur
Catégories et attributs Votre taxonomie ne correspondra pas à celle de TikTok Maintenez une correspondance explicite des catégories et validez les attributs obligatoires avant l’envoi, afin que les erreurs apparaissent dans votre interface d’administration plutôt que sous forme de refus silencieux
Statut des commandes Les statuts TikTok face à vos propres états Associez explicitement chaque statut TikTok et journalisez les valeurs inconnues au lieu de les ignorer
Stock Quel système fait foi ? La base de données de votre site, avec un envoi vers TikTok à chaque changement et un rapprochement complet planifié
Prix et devise Tarification par marché Conservez un champ de prix par canal afin qu’une promotion TikTok ne remplace jamais le prix affiché sur votre site
Données client Les informations acheteur sont des données personnelles Ne stockez que ce qui est nécessaire à l’expédition et respectez les conditions de traitement des données acceptées dans le Partner Center

Pour le stock, prévoir une réserve de sécurité coûte moins cher que de devoir s’excuser. Réserver une petite quantité tampon par canal vous fera perdre quelques ventes au pire ; la survente entraîne des annulations qui pénalisent votre boutique.

Faut-il développer cette intégration en interne ou faire appel à une équipe ?

Développez-la vous-même si vous disposez d’un développeur backend, gérez une seule boutique et avez uniquement besoin des commandes et du suivi. Pour un développeur backend expérimenté, les volets autorisation et webhook représentent quelques jours de travail. La plus grande partie du temps est ensuite consacrée au mapping et à la gestion des erreurs.

Faites-vous accompagner si vous vendez sur plusieurs marchés, synchronisez le catalogue et les stocks dans les deux sens ou utilisez déjà d’autres canaux dans le même système. C’est à ce stade que la tâche de rapprochement, le journal de synchronisation et la gestion des tokens multi-boutiques deviennent indispensables. Notre service d’intégration de l’API TikTok Shop couvre précisément cette couche. Vous pouvez le cadrer avec votre stack avant de vous engager.

Problèmes courants lors de la connexion de TikTok Shop et solutions

Symptôme Cause probable Solution
Tous les appels API échouent avec une erreur de signature La routine de signature diffère de la documentation : ordre des paramètres, traitement du corps ou emplacement du secret Reproduisez le problème avec le SDK officiel ou l’outil de test du Partner Center, puis comparez les entrées
Les appels fonctionnaient hier, mais échouent aujourd’hui L’access token a expiré et son renouvellement n’a pas été exécuté ou a subi une concurrence Utilisez un verrou de renouvellement par boutique et configurez une alerte en cas d’échec
Des commandes sont absentes de votre site Le webhook n’est pas enregistré pour cette boutique, le endpoint a expiré ou l’événement a été perdu Vérifiez le statut de livraison, raccourcissez le traitement du récepteur et ajoutez la tâche de rapprochement
Commandes en double Un événement relancé a été traité deux fois Ajoutez une contrainte d’unicité sur l’événement et les identifiants de commande
Produit présent sur votre site, mais pas sur TikTok La catégorie, un attribut ou une exigence d’image n’a pas été validé Affichez dans votre interface d’administration le motif du refus renvoyé par l’API
Stocks différents entre les canaux Deux canaux ont vendu la dernière unité pendant la fenêtre de synchronisation Utilisez un stock de sécurité et une mise à jour à chaque changement plutôt qu’une synchronisation uniquement périodique

Si vous souhaitez faire relire une architecture de ce type avant de la développer, envoyez-nous votre projet via notre formulaire de devis gratuit en précisant votre site, vos marchés et votre volume de commandes.

FAQ

Questions fréquentes

Puis-je intégrer le tunnel de paiement TikTok Shop à mon propre site ?

Non. Les commandes TikTok Shop sont passées dans TikTok. Connecter un site sur mesure signifie synchroniser les produits, les stocks, les commandes et les informations de suivi entre votre système et TikTok Shop via l’API du Partner Center.

Ai-je besoin d’un compte développeur pour connecter TikTok Shop à un site sur mesure ?

Oui, pour une intégration personnalisée. Vous créez une application dans le TikTok Shop Partner Center, demandez les API scopes nécessaires et faites autoriser l’application par chaque vendeur. Si un connecteur prêt à l’emploi existe pour votre plateforme, vous pouvez éviter de développer directement sur l’API.

Faut-il utiliser des webhooks ou du polling pour recevoir les commandes TikTok Shop ?

Utilisez les deux. Les webhooks permettent de recevoir rapidement les commandes, mais les événements peuvent être dupliqués ou perdus. Une tâche de rapprochement planifiée, qui répertorie les commandes récemment modifiées, garantit qu’aucune commande ne passe inaperçue.

Où dois-je stocker les access tokens et refresh tokens TikTok Shop ?

Uniquement sur votre serveur, chiffrés au repos et jamais dans le code front-end ni dans les logs. Renouvelez-les par boutique avec un verrou afin que des tâches parallèles ne remplacent pas un token récent par une ancienne valeur.

Combien de temps faut-il pour connecter une boutique TikTok Shop à un site sur mesure ?

Pour un développeur backend expérimenté, l’autorisation ainsi que la synchronisation des commandes et du suivi d’une seule boutique prennent généralement quelques jours. La synchronisation du catalogue sur plusieurs marchés, le stock bidirectionnel et la gestion des erreurs sont les éléments qui rallongent les projets plus importants.

Restez informé avec Netalith

Recevez des ressources de développement, des mises à jour produit et des offres spéciales directement dans votre boîte mail.