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.

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 <id>	Une déclinaison de l’abonnement n’existe plus dans PrestaShop	La déclinaison <id> a été supprimée de votre catalogue	Voir ci-dessous
Product combination <id> 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 (<!doctype 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
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
• 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 :

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 <id> 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 :

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 :

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)

Modifier le produit d'un abonnement

Renouvellements PrestaShop expliqués