Problèmes courants : documentation CheckoutOS

Ce guide présente les problèmes CheckoutOS les plus courants et leurs solutions. Si votre problème n’y figure pas, consultez la référence des codes d’erreur ou contactez le support.

Les ventes incitatives ne s’affichent pas

Si vos ventes incitatives après achat n’apparaissent pas après le paiement, procédez à ces vérifications :

Vérifier que la campagne est active

Vérifier les règles de ciblage

Confirmer l’intégration Shopify

Tester avec une vraie commande

Test rapide

Créez une campagne sans règles de ciblage (visible par tous) avec une remise de 100 % sur un produit de faible valeur. Passez une commande de test pour vérifier le fonctionnement du parcours.

Les extensions de paiement n’apparaissent pas

Si les badges de confiance, barres de progression ou autres extensions de paiement ne sont pas visibles :

Exigence Shopify Plus

Les extensions de paiement natives nécessitent :

Un forfait Shopify Plus, ou
L’accès à la version bêta de Checkout Extensibility (disponible pour certaines boutiques sans Plus)

Vérifiez votre forfait dans Shopify Admin → Settings → Plan.

Placement des extensions

Vérifiez que les extensions sont placées dans une zone visible :

Accéder à Shopify Admin → Settings → Checkout → Customize
Repérer les extensions CheckoutOS dans les blocs disponibles
Les faire glisser à l’emplacement souhaité dans la mise en page du paiement
Enregistrer et prévisualiser les modifications

Conflits de remises

Les remises CheckoutOS peuvent entrer en conflit avec les remises Shopify existantes ou d’autres applications. Les symptômes courants incluent :

La remise de vente incitative ne s’applique pas
Le montant de remise affiché est incorrect
Plusieurs remises se cumulent de manière inattendue

Cumul des réductions

Shopify limite les combinaisons de remises. Si un client a déjà appliqué un code de réduction, les remises de vente incitative CheckoutOS peuvent ne pas s’appliquer. Configurez vos règles dans Dashboard → Settings → Discount Functions.

Étapes de résolution

Examiner les remises actives

Vérifier les paramètres de combinaison des remises

Configurer la priorité CheckoutOS

Chargement lent ou délai dépassé

Si les fonctionnalités CheckoutOS se chargent lentement ou dépassent le délai :

Problèmes réseau

Vérifier la stabilité de votre connexion Internet
Essayer de vider le cache et les cookies du navigateur
Tester dans une fenêtre de navigation privée
Désactiver temporairement les extensions du navigateur

Conflits d’applications

D’autres applications Shopify peuvent parfois entrer en conflit avec CheckoutOS :

Désactiver temporairement les autres applications liées au paiement
Vérifier les erreurs JavaScript dans la console de développement du navigateur
Examiner les applications récemment installées susceptibles d’affecter le paiement

Vérifier les erreurs JavaScript

// Open browser developer tools (F12) and check the Console tab
// Look for errors mentioning:
// - chargezen
// - checkoutos
// - checkout-extension

// Common error patterns:
// "Failed to load resource" - Network/CORS issue
// "undefined is not a function" - JavaScript conflict
// "Extension blocked" - CSP or ad blocker issue

Les analyses ne suivent pas les données

Si votre tableau de bord n’affiche aucune donnée ou présente des indicateurs incorrects :

Retard des données

Les indicateurs du tableau de bord ont un décalage de 15 minutes. Pour des données en temps réel, utilisez la section Analytics, qui fournit des mises à jour en direct.

Vérifier le suivi

Vérifier le statut de l’intégration

Examiner le statut des webhooks

Passer une commande test

Problèmes d’affichage mobile

Si les fonctionnalités CheckoutOS ne s’affichent pas correctement sur les appareils mobiles :

Tester sur de vrais appareils, pas uniquement avec l’émulation du navigateur
Vérifier les paramètres mobiles dans Dashboard → Settings → Store → Mobile Behavior
Examiner le CSS personnalisé pour repérer les problèmes de points de rupture mobiles
S’assurer que le thème Shopify s’adapte aux écrans mobiles

Le problème persiste ?

Codes d’erreur

Rechercher des codes d’erreur précis et leur signification

Contacter l’assistance

Obtenir l’aide de notre équipe de support