Messages d'erreur API PrestaShop

Astuce

Ce guide référence les messages d’erreur que Ciklik peut remonter lors de l’interaction avec l’API PrestaShop (création de paniers, ajout de produits, gestion des déclinaisons, etc.).

Prérequis

• Connaissance de l’architecture PrestaShop (produits, déclinaisons, paniers)
• Accès au back-office PrestaShop et Ciklik
• Familiarité avec les concepts d’id_product et id_product_attribute PrestaShop

Référence des messages d’erreur

Message d’erreur	Contexte PrestaShop	Action recommandée
Missing parameter : id	Paramètre ID manquant dans la requête vers PrestaShop	Vérifier l’intégrité de l’abonnement dans Ciklik et la cohérence avec le catalogue PrestaShop
Bad parameter : id	Paramètre ID invalide — la déclinaison ou le produit a été supprimé/modifié dans le back-office PrestaShop	Recréer la déclinaison ou mettre à jour le produit de l’abonnement
Cart not found	Le panier PrestaShop référencé n’existe plus	Régénérer le panier (problème souvent lié à un nettoyage de base de données côté PrestaShop)
Missing parameter : id_product_attribute	Déclinaison PrestaShop non spécifiée	Le produit configuré dans l’abonnement nécessite une déclinaison (taille, couleur, conditionnement, etc.)

Erreur la plus fréquente : Bad parameter : id

Piège courant — Suppression de déclinaison PrestaShop

C’est la cause n°1 d’erreurs de rebill récurrentes.

Si un marchand supprime une déclinaison (id_product_attribute) dans son back-office PrestaShop alors que des abonnements y font référence, tous les rebills concernés échoueront systématiquement avec l’erreur Bad parameter : id.

Scénario typique

1. Le marchand crée 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. Le marchand décide de réorganiser son catalogue et supprime 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 Bad parameter : id

Solutions

L’abonnement ne pourra plus se renouveler tant que l’une de ces actions n’est pas effectuée :

Option 1 : Recréer la déclinaison avec le même ID (complexe)

• Nécessite une intervention en base de données PrestaShop
• Non recommandé car risqué

Option 2 : Mettre à jour le produit de l’abonnement côté Ciklik (recommandé)

• Via le back-office Ciklik : Modifier le produit d’un abonnement
• Ou via l’API Ciklik pour les modifications en masse

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 filtrer les abonnements par produit :

GET /api/subscriptions?filter[product_id]=42&filter[status]=active

Erreur Cart not found

Cette erreur survient quand le panier PrestaShop référencé par Ciklik n’existe plus.

Causes possibles

• Nettoyage automatique des paniers : PrestaShop supprime par défaut les paniers abandonnés après un certain délai. Si un rebill est décalé (indisponibilité serveur, etc.), le panier initial peut avoir été supprimé.

• Purge manuelle de la base de données : Nettoyage des tables ps_cart et ps_cart_product sans précaution.

• Module de maintenance : Certains modules de nettoyage PrestaShop suppriment les paniers “orphelins”.

Solution

Le rebill sera automatiquement retenté avec création d’un nouveau panier. Si l’erreur persiste, vérifiez la configuration du nettoyage automatique des paniers dans PrestaShop.

Erreur Missing parameter : id_product_attribute

Cette erreur indique que le produit configuré dans l’abonnement possède des déclinaisons obligatoires, mais qu’aucune déclinaison n’a été spécifiée.

Causes possibles

• L’abonnement a été créé avant que des déclinaisons soient ajoutées au produit
• Migration de données incomplète
• Bug lors de la création de l’abonnement

Solution

Mettre à jour l’abonnement pour spécifier la déclinaison souhaitée via Modifier le produit d’un abonnement.

Diagnostic et résolution

Étape 1 : Identifier les abonnements en erreur

Via 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 catalogue

Comparez :

• L’ID produit/déclinaison stocké dans l’abonnement Ciklik
• L’existence de cet ID dans le catalogue PrestaShop

Étape 4 : Corriger

Selon le diagnostic :

• Mettre à jour le produit de l’abonnement
• Recréer les éléments manquants dans PrestaShop
• Contacter le support Ciklik pour les cas complexes

FAQ

Q : Comment identifier tous les abonnements impactés par une suppression de déclinaison ?

Filtrez les abonnements actifs par l’ID de déclinaison concerné via l’API :

GET /api/subscriptions?filter[id_product_attribute]=42&filter[status]=active

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, ces erreurs sont capturées par Ciklik avant d’atteindre PrestaShop. Elles sont visibles uniquement dans le back-office Ciklik ou via l’API rebill-errors.