> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aftersell.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Dépannage d'Upcart qui ne s'ouvre pas ou redirige vers la page du panier

> Guide de dépannage des problèmes de tiroir de panier dans Upcart, notamment le tiroir qui ne s'ouvre pas, la redirection vers la page du panier, deux paniers apparaissant en même temps, le panier qui ne se charge pas, ou Upcart qui ne répond pas lors de l'ajout d'articles au panier.

Si Upcart ne s'ouvre pas lorsque les clients ajoutent des articles à leur panier, s'ouvre puis redirige vers la page du panier, si un double panier apparaît, ou si aucun n'apparaît du tout, ce guide vous aidera à identifier et résoudre le problème.

<div id="what-are-you-experiencing">
  ## Que constatez-vous ?
</div>

Commencez ici pour accéder directement à la bonne solution :

* [**Upcart s'ouvre brièvement, puis redirige vers la page du panier**](#issue-1--2-upcart-redirecting-to-the-cart-page)
* [**Les clients sont dirigés directement vers la page du panier au lieu de voir Upcart**](#issue-1--2-upcart-redirecting-to-the-cart-page)
* [**Deux paniers apparaissent en même temps (Upcart et le panier du thème)**](#3-change-theme-cart-type-to-page)
* [**Upcart ne s'ouvre pas du tout**](#issue-4-upcart-is-not-opening-at-all)

Vous ne savez pas quel cas s'applique ? Commencez par l'[étape 1](#step-1-make-sure-upcart-is-fully-active) pour confirmer qu'Upcart est entièrement activé avant de vous plonger dans un problème spécifique.

La plupart des problèmes de tiroir de panier Upcart sont causés par :

* Upcart n'étant pas entièrement activé
* Des paramètres de panier du thème en conflit avec Upcart
* La configuration d'Enhanced AJAX API Compatibility
* Des applications tierces qui remplacent le comportement du panier
* Des tiroirs de panier du thème en conflit avec Upcart

Suivez les étapes ci-dessous dans l'ordre et testez après chaque modification.

***

<div id="step-1-make-sure-upcart-is-fully-active">
  ## Étape 1 : assurez-vous qu'Upcart est entièrement actif
</div>

Avant tout autre dépannage, confirmez qu'Upcart est correctement activé.

<div id="1-ensure-the-cart-is-activated">
  ### 1. Vérifiez que le panier est activé
</div>

Si le panier est désactivé dans l'éditeur Upcart, il n'apparaîtra pas sur votre boutique en ligne.

* Ouvrez Upcart
* Allez dans **Manage all carts**
* Confirmez que le panier est publié

<div id="2-enable-the-app-embed">
  ### 2. Activez l'app embed
</div>

Si l'app embed est désactivé, Upcart ne se chargera pas.

* Allez dans **Shopify Admin > Online Store > Themes > Customize**
* Ouvrez **App Embeds**
* Activez **Upcart**
* Enregistrez

Testez votre panier après avoir activé ces paramètres.

<img src="https://mintcdn.com/aftersell/uxKAdY-e0h16xa48/images/upcart/cart-not-opening-activate-cart-app-embed.gif?s=244802191623615202cc95d61431de84" alt="Activation du panier Upcart et de son app embed dans l'interface d'administration Shopify" width="2044" height="1080" data-path="images/upcart/cart-not-opening-activate-cart-app-embed.gif" />

***

<div id="issue-1--2-upcart-redirecting-to-the-cart-page">
  ## Problèmes 1 et 2 : Upcart redirige vers la page du panier
</div>

Si Upcart s'ouvre brièvement puis redirige, ou si les clients sont dirigés directement vers la page du panier, cela est généralement causé par l'un des éléments suivants. Parcourez chaque étape et testez après chaque modification.

<div id="1-check-checkout-button-setting-in-upcart">
  ### 1. Vérifiez le paramètre du bouton de paiement dans Upcart
</div>

Si les clients cliquent sur Checkout et sont renvoyés vers la page du panier :

1. Allez dans **Upcart > Cart Editor > Settings > Cart settings**
2. Localisez **« Go to cart page when pressing checkout button »**
3. Désactivez cette option (**OFF**)
4. Enregistrez et testez

Lorsqu'elle est activée, cette option force le bouton de paiement à rediriger vers la page du panier au lieu de poursuivre vers le paiement.

<img src="https://mintcdn.com/aftersell/uxKAdY-e0h16xa48/images/upcart/cart-not-opening-go-to-cart-page-setting.gif?s=96670b4dedac961d37c1e39b80caea4a" alt="Paramètres du panier Upcart mettant en évidence l'option Go to cart page when pressing checkout" width="1180" height="1080" data-path="images/upcart/cart-not-opening-go-to-cart-page-setting.gif" />

<div id="2-check-enhanced-ajax-api-compatibility">
  ### 2. Vérifiez Enhanced AJAX API Compatibility
</div>

Allez dans **Upcart > Cart Editor > Settings > Cart settings**, développez **Advanced Settings** et localisez **Enhanced AJAX API Compatibility**.

Ce paramètre modifie la façon dont Upcart gère les événements Add to Cart :

* **Désactivé (recommandé pour la plupart des boutiques)** - Upcart intercepte les appels Add to Cart et empêche les redirections
* **Activé** - Upcart cesse d'intercepter les appels Add to Cart, permettant à d'autres applications de contrôler le comportement du panier, y compris les redirections

Ce paramètre est **désactivé par défaut**. Activez-le UNIQUEMENT si votre boutique utilise une API de panier AJAX non standard et qu'Upcart n'intercepte pas les événements d'ajout au panier. Si l'activation de ce paramètre provoque des redirections, désactivez-le et utilisez plutôt l'API manuelle d'Upcart (`upcartRegisterAddToCart`).

Pour des instructions complètes, consultez [Enhanced AJAX API Compatibility](/fr/upcart/enhanced_ajax_api_compatibility).

<img src="https://mintcdn.com/aftersell/Dz_83h-jRD2tmZWk/images/upcart/cart-not-opening-enhanced-ajax-api-compatibility.gif?s=7c3a3fc600bca7b421d57241bb740a78" alt="Le paramètre Enhanced Ajax API compatibility et sa description dans Upcart" width="2084" height="1080" data-path="images/upcart/cart-not-opening-enhanced-ajax-api-compatibility.gif" />

<div id="3-change-theme-cart-type-to-page">
  ### 3. Changez le type de panier du thème en « Page »
</div>

Le tiroir de panier ou la popup de votre thème peut remplacer Upcart.

1. Allez dans **Shopify Admin > Online Store > Themes**
2. Cliquez sur **Customize**
3. Ouvrez **Theme Settings > Cart**
4. Changez **Cart Type** en **Page**
5. Enregistrez et testez

Régler le panier sur « Page » empêche le tiroir natif du thème de s'ouvrir à la place d'Upcart.

<img src="https://mintcdn.com/aftersell/uxKAdY-e0h16xa48/images/upcart/cart-type-theme-editor-settings-option.gif?s=81eef4e6af5190720b3eb86be578c605" alt="Réglage du type de panier du thème sur Page dans les paramètres du thème Shopify" width="644" height="1080" data-path="images/upcart/cart-type-theme-editor-settings-option.gif" />

<Note>
  Si votre thème n'inclut pas de paramètre « Cart Type » (ou équivalent), contactez le développeur de votre thème pour localiser ou ajouter la bonne option. Upcart ne peut pas modifier directement les paramètres du thème.
</Note>

<div id="4-disable-theme-cart-redirect-settings">
  ### 4. Désactivez les paramètres de redirection de panier du thème
</div>

Certains thèmes redirigent automatiquement les clients vers la page du panier après l'ajout d'un produit, contournant complètement Upcart.

1. Allez dans **Shopify Admin > Online Store > Themes > Customize**
2. Ouvrez **Theme Settings > Products** (ou Cart)
3. Recherchez des paramètres tels que :
   * Enable cart redirection
   * Redirect to cart after add
   * Go to cart after add
4. Désactivez-les (**OFF**), enregistrez et testez

<div id="5-check-for-conflicts-with-other-apps">
  ### 5. Vérifiez les conflits avec d'autres applications
</div>

De nombreuses applications tierces remplacent le comportement du panier. Ouvrez les paramètres de toutes les applications liées au panier et recherchez des options telles que :

* Redirect to cart
* Go to cart after add
* Automatically open cart page
* Action after product is added

Changez-les en **Stay on page** ou **Do nothing** et testez après chaque ajustement.

**Corrections courantes spécifiques aux applications :**

* **Globo Product Options** - Désactivez « Redirect to the shopping cart page after adding a product »
* **Zepto Product Personalizer** - Allez dans Zepto > Settings > Add to Cart Settings et changez « Action after a product is added to the cart » en « Stay on the product page and show a success message »
* **PageFly** - Désactivez toute règle de redirection de panier dans les paramètres de PageFly
* **Replo** - Ajustez les paramètres « go to page » pour permettre l'ouverture du tiroir de panier

Si vous ne savez pas quelle application cause le conflit, désactivez les applications liées au panier une par une et testez après chacune jusqu'à ce qu'Upcart fonctionne.

***

<div id="issue-4-upcart-is-not-opening-at-all">
  ## Problème 4 : Upcart ne s'ouvre pas du tout
</div>

Si rien ne se passe lorsque les clients ajoutent au panier ou cliquent sur l'icône du panier, cela est généralement causé par un conflit de thème ou par le fait qu'Upcart ne détecte pas les bons boutons.

<div id="disable-themes-native-cart-drawer">
  ### Désactivez le tiroir de panier natif du thème
</div>

1. Allez dans **Shopify Admin > Online Store > Themes > Customize**
2. Ouvrez **Theme Settings > Cart**
3. Réglez le type de panier sur **Page**
4. Enregistrez

Assurez-vous que les modes Drawer ou Popup sont désactivés.

<div id="upcart-not-detecting-your-buttons">
  ### Upcart ne détecte pas vos boutons ?
</div>

Certains thèmes utilisent du code personnalisé qui empêche Upcart de détecter automatiquement le bouton Add to Cart ou l'icône du panier. Si c'est le cas, vous pouvez spécifier manuellement les sélecteurs de boutons.

**Étape 1 : trouvez le nom de classe**

1. Ouvrez votre boutique dans **Google Chrome**
2. Faites un clic droit sur le **bouton Add to Cart** ou l'**icône du panier**
3. Cliquez sur **Inspect**
4. Dans le code mis en surbrillance, recherchez quelque chose comme :

```text theme={"theme":{"light":"snazzy-light","dark":"github-dark"}}
class="icon icon-cart"
```

ou

```text theme={"theme":{"light":"snazzy-light","dark":"github-dark"}}
class="product-form__submit button"
```

Copiez seulement **un nom de classe** (par exemple : `icon-cart`). Ne copiez pas `class=` ni les guillemets.

<img src="https://mintcdn.com/aftersell/uxKAdY-e0h16xa48/images/upcart/cart-not-opening-devtools-find-class.gif?s=1899e34961f704c4e9919620e3159376" alt="Inspection de l'icône du panier dans Chrome DevTools pour trouver son nom de classe" width="1600" height="1080" data-path="images/upcart/cart-not-opening-devtools-find-class.gif" />

**Étape 2 : ajoutez-le dans Upcart**

Vous devez ajouter un **point (.)** avant le nom de classe lorsque vous le saisissez dans Upcart. Par exemple : `.icon-cart`

1. Ouvrez **Upcart**
2. Allez dans **Cart Editor > Settings > Cart settings**, puis développez **Advanced Settings**
3. Trouvez le groupe de sélecteurs dont vous avez besoin :
   * **Open cart button selector** — pour l'icône du panier
   * **Add to cart button selector** — pour le bouton d'ajout au panier
4. Dans le menu déroulant **Options** de ce groupe, choisissez **Add additional selector** (conserve la détection propre d'Upcart et ajoute la vôtre) ou **Use custom selector** (la vôtre uniquement). Le champ **Custom selector** reste désactivé tant que **Use default selector** est sélectionné.
5. Collez `.icon-cart` dans **Custom selector** et enregistrez

<img src="https://mintcdn.com/aftersell/uxKAdY-e0h16xa48/images/upcart/cart-not-opening-custom-open-selector.gif?s=d437f6359066a7aa26467f85611f13d2" alt="Saisie d'un sélecteur Open cart button personnalisé dans les paramètres avancés d'Upcart" width="1064" height="1080" data-path="images/upcart/cart-not-opening-custom-open-selector.gif" />

***

<div id="additional-troubleshooting">
  ## Dépannage supplémentaire
</div>

Si le problème persiste après avoir suivi les étapes ci-dessus, essayez les actions suivantes une par une, en testant après chaque modification.

<div id="toggle-shadow-dom-onoff">
  ### Basculer le Shadow DOM (ON/OFF)
</div>

Dans certains thèmes, le paramètre Shadow DOM affecte la façon dont Upcart détecte les boutons et les événements du panier.

1. Allez dans **Upcart > Cart Editor > Settings > Cart settings**, puis développez **Advanced Settings**
2. Localisez **Render cart in shadow DOM**
3. Activez (**ON**), enregistrez et testez
4. Désactivez (**OFF**), enregistrez et testez à nouveau

Utilisez le réglage qui produit un comportement cohérent.

<div id="toggle-ajax-setting-onoff">
  ### Basculer le paramètre AJAX (ON/OFF)
</div>

Certaines boutiques se comportent mieux avec la gestion AJAX inversée, selon la configuration du thème et des applications.

1. Allez dans **Upcart > Cart Editor > Settings > Cart settings**, puis développez **Advanced Settings**
2. Localisez **Enhanced Ajax API compatibility**
3. Activez (**ON**), enregistrez et testez
4. Désactivez (**OFF**), enregistrez et testez à nouveau

Notez que ce paramètre désactive également la gestion propre d'Upcart de l'Add to Cart, donc si son activation corrige la redirection, il vaut la peine de confirmer que l'ajout au panier se comporte toujours comme prévu. Consultez [Enhanced Ajax API compatibility](/fr/upcart/enhanced_ajax_api_compatibility).

<div id="clear-browser-cache">
  ### Vider le cache du navigateur
</div>

D'anciens scripts mis en cache peuvent conserver un comportement de panier antérieur et empêcher Upcart de se charger correctement.

1. Ouvrez les paramètres du navigateur
2. Allez dans **Privacy & Security**
3. Sélectionnez **Clear Browsing Data**
4. Effacez les images, fichiers et cookies mis en cache
5. Actualisez et testez

<div id="test-with-a-default-shopify-theme">
  ### Tester avec un thème Shopify par défaut
</div>

1. Allez dans **Shopify Admin > Online Store > Themes**
2. Ajoutez un thème gratuit tel que Dawn
3. Activez-le temporairement
4. Testez Upcart

Si Upcart fonctionne avec Dawn, le problème est spécifique à votre thème personnalisé. Contactez le développeur de votre thème pour obtenir de l'aide.

<div id="disable-apps-one-by-one">
  ### Désactiver les applications une par une
</div>

1. Allez dans **Shopify Admin > Apps**
2. Désactivez une application liée au panier à la fois
3. Testez après chacune

Lorsqu'Upcart commence à fonctionner, vous avez identifié l'application en conflit.

<div id="check-browser-console-for-errors">
  ### Vérifier les erreurs dans la console du navigateur
</div>

1. Ouvrez votre boutique
2. Appuyez sur **F12** (ou clic droit > Inspect)
3. Ouvrez l'onglet **Console**
4. Ajoutez un produit au panier
5. Recherchez des erreurs, en particulier tout ce qui concerne add.js ou les événements de panier
6. Faites une capture d'écran des erreurs à partager avec le support

***

<div id="when-to-contact-support">
  ## Quand contacter le support
</div>

Si vous avez effectué toutes les étapes et qu'Upcart ne fonctionne toujours pas, contactez le support avec :

* Le nom et la version du thème
* La liste des applications liées au panier installées
* Des captures d'écran des erreurs de la console
* Les étapes que vous avez déjà essayées

Vous pouvez joindre le support Upcart via le chat intégré à l'application ou par e-mail à [support@upcart.app](mailto:support@upcart.app).
