--- title: "Messages d'erreur API PrestaShop" description: "Les messages que le module Ciklik renvoie quand un panier de renouvellement échoue, la cause affichée dans Ciklik et le remède pour chacun." url: https://www.ciklik.academy/fr/prestashop/gestion-abonnes-ciklik/messages-erreur-api-prestashop/ lang: fr lastUpdated: 2026-10-09 --- # Messages d'erreur API PrestaShop > PrestaShop > > Cette page concerne les boutiques PrestaShop équipées du module Ciklik. Vous avez une boutique box Ciklik ? [Voir le parcours box](https://www.ciklik.academy/fr/demarrage/bienvenue-chez-ciklik/). > Astuce > > À chaque renouvellement, Ciklik demande au module de votre boutique de créer le panier de la commande. Si le module refuse, son message est enregistré dans les erreurs de renouvellement de l’abonnement. Cette page liste ces messages, la cause affichée dans Ciklik et le remède. ## Prérequis - Connaissance des produits et déclinaisons PrestaShop (`id_product`, `id_product_attribute`) - Accès au back-office PrestaShop et à Ciklik ## Référence des messages d’erreur La colonne “Cause dans Ciklik” reprend le libellé affiché dans le panneau **Situation du renouvellement** de l’abonnement. | Message d’erreur | Cause dans Ciklik | Ce qui se passe | Action recommandée | | ---------------------------------------------- | ---------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `Product not found for variant ` | Une déclinaison de l’abonnement n’existe plus dans PrestaShop | La déclinaison `` a été supprimée de votre catalogue | Voir [ci-dessous](#erreur-la-plus-fr%C3%A9quente--product-not-found-for-variant) | | `Product combination not found` | Une déclinaison de l’abonnement n’existe plus dans PrestaShop | La déclinaison d’un produit ajouté en upsell a été supprimée | Le client peut retirer ce produit dans **Mon compte > Vos abonnements**, section **Produits additionnels non récurrents** ; sinon, contactez le support Ciklik | | Page HTML (`…`) | Votre boutique n’a pas répondu à Ciklik | La boutique a renvoyé une page (maintenance, protection, erreur serveur) au lieu de la réponse du module | Voir [Rebill et indisponibilité du site PrestaShop](https://www.ciklik.academy/fr/prestashop/gestion-abonnes-ciklik/rebill-et-indisponibilite-site/) | | `Invalid fingerprint: …` | Le panier de l’abonnement est illisible, Ciklik en a été informé | Le module ne lit pas les informations de panier envoyées par Ciklik, par exemple après une mise à jour du module | Contactez le support Ciklik avec l’ID de l’abonnement | | `Customer not found` | Le client n’existe plus dans PrestaShop | Le client de l’abonnement a été supprimé de votre boutique | Vérifiez le client dans PrestaShop ; s’il a bien été supprimé, résiliez l’abonnement | | `Cart not found` | Raison non identifiée, le support Ciklik peut vous aider | Le panier préparé pour le renouvellement n’existe plus | Rien à faire : Ciklik recrée un panier | | `Missing parameter : …` ou `Bad parameter : …` | Raison non identifiée, le support Ciklik peut vous aider | Requête incomplète entre Ciklik et le module | Contactez le support Ciklik avec l’ID de l’abonnement | ## Erreur la plus fréquente : `Product not found for variant` > Piège courant : suppression d’une déclinaison PrestaShop > > C’est la **cause n°1 des erreurs de renouvellement récurrentes liées au catalogue**. > > Si vous supprimez une déclinaison (`id_product_attribute`) dans votre back-office PrestaShop alors que des abonnements y font référence, **tous les renouvellements concernés échouent** avec `Product not found for variant` suivi de l’identifiant de la déclinaison. ### Scénario typique 1. Vous créez un produit “Café 250g” avec deux déclinaisons : - Moulu (id_product_attribute = 42) - En grains (id_product_attribute = 43) 2. Des clients s’abonnent à la déclinaison “Moulu” (id = 42). 3. Vous réorganisez votre catalogue : vous supprimez la déclinaison “Moulu” pour la recréer différemment. 4. La nouvelle déclinaison “Moulu” a maintenant l’id 87. 5. **Résultat** : tous les abonnements qui référençaient l’id 42 échouent avec `Product not found for variant 42`. ### Solutions L’abonnement ne pourra plus se renouveler tant que l’une de ces actions n’est pas effectuée : **Option 1 : mettre à jour le produit de l’abonnement dans Ciklik** (recommandé) - Depuis le back-office Ciklik : [Modifier le produit d’un abonnement](https://www.ciklik.academy/fr/prestashop/gestion-abonnes-ciklik/modifier-le-produit-d-un-abonnement/) - Ou via l’API Ciklik pour les modifications en masse **Option 2 : activer l’option du module ci-dessous**, si votre boutique est en mode fréquences. > Bonne pratique > > **Avant toute suppression de déclinaison dans PrestaShop**, vérifiez qu’aucun abonnement actif n’y fait référence. > > Utilisez l’API Ciklik pour lister les abonnements actifs, puis repérez ceux dont le contenu (`content[].external_id`) correspond à ce produit et à cette déclinaison : > > ```bash > GET /api/subscriptions?filter[activated]=1 > ``` ## Passer sur la déclinaison par défaut si supprimée Cette option du module remplace automatiquement, au renouvellement, une déclinaison supprimée par la **déclinaison par défaut** du produit. 1. Dans le back-office PrestaShop, ouvrez la configuration du module Ciklik. 2. Passez **Passer sur la déclinaison par défaut si supprimée** sur **Oui**, puis cliquez sur **Enregistrer**. Ce qu’il faut savoir avant de l’activer : - **Mode fréquences seulement.** L’option agit sur les abonnements dont le contenu porte le produit et la déclinaison (`id_product:id_product_attribute`), c’est-à-dire ceux créés en mode fréquences. En mode déclinaisons, l’abonnement ne porte que l’identifiant de la déclinaison : si elle est supprimée, le module ne retrouve plus le produit et l’erreur `Product not found for variant` reste. - **Vérifiez la déclinaison par défaut.** Le client reçoit la déclinaison par défaut du produit, pas forcément celle qu’il avait choisie. Assurez-vous qu’elle convient pour un abonné. - **Les produits en upsell ne sont pas concernés** : une déclinaison d’upsell supprimée donne toujours `Product combination not found`. - Chaque remplacement est noté dans les journaux PrestaShop (**Paramètres avancés > Logs**) avec le message “Falling back to default attribute for product…”. Corrigez ensuite le produit de l’abonnement dans Ciklik pour ne plus dépendre de l’option. ## Erreur `Cart not found` Cette erreur survient quand le panier préparé pour le renouvellement n’existe plus dans votre boutique. ### Causes possibles - **Nettoyage automatique des paniers** : un module de nettoyage supprime les paniers anciens ou “orphelins” avant que le renouvellement soit confirmé. - **Purge manuelle de la base de données** : nettoyage des tables `ps_cart` et `ps_cart_product` sans précaution. ### Solution Ciklik recrée un panier avec les mêmes produits et termine le renouvellement. Si l’erreur revient souvent, vérifiez les réglages de nettoyage des paniers de votre boutique. ## Diagnostic et résolution ### Étape 1 : identifier les abonnements en erreur Dans Ciklik, la lentille **Renouvellements bloqués** de **Ventes > Abonnements** liste les abonnements bloqués avec leur cause. Par l’API rebill-errors : ```bash GET /api/rebill-errors?filter[created_at_after]=2026-01-01 ``` ### Étape 2 : analyser le message d’erreur Reportez-vous au tableau de référence ci-dessus pour comprendre la cause. ### Étape 3 : vérifier la cohérence du catalogue Comparez : - l’identifiant produit et déclinaison de l’abonnement dans Ciklik ; - l’existence de cet identifiant dans le catalogue PrestaShop. ### Étape 4 : corriger Selon le diagnostic : - mettez à jour le produit de l’abonnement ; - recréez les éléments manquants dans PrestaShop ; - contactez le support Ciklik pour les cas complexes. ## FAQ **Q : Comment identifier tous les abonnements touchés par une suppression de déclinaison ?** L’API ne filtre pas par déclinaison : listez les abonnements actifs, puis repérez ceux dont le contenu (`content[].external_id`) correspond à la déclinaison concernée : ```bash GET /api/subscriptions?filter[activated]=1 ``` **Q : Puis-je modifier en masse les produits des abonnements ?** Oui, via l’API Ciklik. Contactez le support pour un accompagnement sur les modifications en masse. **Q : Ces erreurs sont-elles visibles dans le back-office PrestaShop ?** Non. Le module renvoie le message à Ciklik, qui l’enregistre : vous le retrouvez dans les erreurs de renouvellement de l’abonnement et de votre site dans Ciklik, ou par l’API rebill-errors. ## Voir aussi [Comprendre les erreurs de renouvellement (rebill errors)](https://www.ciklik.academy/fr/prestashop/gestion-abonnes-ciklik/comprendre-les-erreurs-de-renouvellement/) [Modifier le produit d'un abonnement](https://www.ciklik.academy/fr/prestashop/gestion-abonnes-ciklik/modifier-le-produit-d-un-abonnement/) [Renouvellements PrestaShop expliqués](https://www.ciklik.academy/fr/prestashop/gestion-abonnes-ciklik/renouvellements-prestashop-expliques/)