Codes d’erreur

Cette référence présente les codes d’erreur que vous pouvez rencontrer dans CheckoutOS. Chaque erreur est accompagnée de sa signification et des étapes de résolution recommandées.

Cause : Impossible d’établir la connexion avec votre boutique Shopify.

Solutions :

• Vérifier que l’URL de la boutique Shopify est correcte
• Vérifier que la boutique Shopify est active (ni en pause ni suspendue)
• Réinstaller CheckoutOS depuis le Shopify App Store
• S’assurer de disposer des autorisations d’administrateur ou de propriétaire sur la boutique Shopify

Cause : CheckoutOS ne dispose pas des autorisations nécessaires.

Solutions :

• Réinstaller l’application pour autoriser de nouveau les accès
• Vérifier que vous êtes connecté en tant que propriétaire ou administrateur de la boutique
• Vérifier le statut des autorisations dans Shopify Admin → Apps → CheckoutOS

Cause : Votre forfait Shopify ne prend pas en charge les extensions de paiement.

Solutions :

• Passer à Shopify Plus pour bénéficier de toutes les possibilités de personnalisation du paiement
• Demander l’accès à la version bêta de Checkout Extensibility (boutiques sans Plus)
• Utiliser uniquement les fonctionnalités après achat (disponibles sur tous les forfaits)

Cause : Des paramètres de la campagne sont absents ou non valides.

Solutions :

• Examiner tous les champs obligatoires de la campagne
• S’assurer qu’au moins un produit est sélectionné pour la vente incitative
• Vérifier que les valeurs de remise sont dans les plages autorisées

Cause : Un produit de votre campagne n’existe plus ou est indisponible.

Solutions :

• Vérifier si le produit a été supprimé de votre catalogue Shopify
• Vérifier que le produit est publié et actif
• Mettre à jour la campagne avec des identifiants de produits valides

Cause : Les règles de ciblage de la campagne se contredisent.

Solutions :

• Examiner la logique ET/OU des règles de ciblage
• S’assurer que les valeurs minimales et maximales ne se chevauchent pas de manière incorrecte
• Rechercher des conditions impossibles (par exemple, panier > US$100 ET panier < US$50)

Cause : Impossible d’appliquer la remise au produit de vente incitative.

Solutions :

• Rechercher des codes de réduction Shopify en conflit
• Vérifier les paramètres de combinaison des remises dans Shopify
• S’assurer que le produit n’est pas exclu des remises

Cause : Impossible de débiter le client pour le produit de vente incitative.

Solutions :

• Il s’agit généralement d’un problème de passerelle de paiement Shopify
• Vérifier le statut de la passerelle dans Shopify Admin → Settings → Payments
• Le client peut devoir réessayer avec un autre moyen de paiement

Cause : Le produit de vente incitative est en rupture de stock.

Solutions :

• Activer les solutions de secours du suivi des stocks dans les paramètres de campagne
• Configurer des produits de remplacement en cas de rupture de stock
• Configurer "Continue selling when out of stock" dans Shopify si nécessaire

Cause : La requête API a utilisé une clé non valide ou expirée.

Solutions :

• Régénérer la clé API dans Dashboard → Settings → API
• Rechercher des fautes de frappe ou des espaces dans la clé
• S’assurer que la clé dispose des autorisations nécessaires

Cause : Trop de requêtes API dans un court intervalle.

Solutions :

• Mettre en place une limitation du débit des requêtes dans votre application
• Utiliser les événements webhook plutôt que l’interrogation périodique
• Contacter le support si des limites de débit plus élevées sont nécessaires

Cause : La vérification de la signature du webhook a échoué.

Solutions :

• Vérifier que le secret webhook correspond à celui de Dashboard → Settings → API
• S’assurer d’utiliser le corps brut de la requête pour vérifier la signature
• Vérifier que l’horloge du serveur est synchronisée

Cause : L’extension de paiement n’a pas pu se charger dans le navigateur.

Solutions :

• Rechercher des erreurs JavaScript dans la console du navigateur
• Désactiver temporairement les bloqueurs de publicité ou extensions de confidentialité
• Vider le cache du navigateur et réessayer
• Tester dans un autre navigateur

Cause : L’extension s’est chargée, mais son affichage a échoué.

Solutions :

• Rechercher des conflits de CSS personnalisé
• Vérifier que les URL des images sont valides et accessibles
• Examiner la configuration de l’extension pour repérer des paramètres non valides