> ## 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.

# Questions fréquentes sur l'API Upcart

> Trouvez des réponses aux questions courantes sur l'utilisation de l'API d'Upcart, y compris la configuration, le dépannage et les intégrations tierces.

<div id="overview">
  # Aperçu
</div>

Voici des réponses à quelques-unes des questions les plus courantes sur l'utilisation de l'API d'Upcart.

* **[Où ajouter les scripts de l'API Upcart ?](#where-to-add-upcart-api-scripts)**
* **[Dois-je être développeur pour utiliser l'API d'Upcart ?](#do-i-need-to-be-a-developer-to-use-upcarts-api)**
* **[L'API d'Upcart peut-elle s'intégrer à d'autres applications tierces ?](#can-upcarts-api-integrate-with-other-third-party-apps)**
* **[Comment tester si mes modifications d'API fonctionnent ?](#how-do-i-test-if-my-api-changes-are-working)**
* **[Que faire si un script API ne fonctionne pas ?](#what-should-i-do-if-an-api-script-isnt-working)**
* **[Comment annuler des modifications si j'ajoute un script qui casse quelque chose ?](#how-do-i-undo-changes-if-i-add-a-script-that-breaks-something)**

***

<div id="where-to-add-upcart-api-scripts">
  ## **Où ajouter les scripts de l'API Upcart ?**
</div>

Vous pouvez ajouter des scripts dans les paramètres Custom HTML d'Upcart ou directement dans le code de votre thème Shopify. La meilleure option dépend de vos besoins de personnalisation.

<div id="how-do-i-use-upcarts-custom-html">
  ## Comment utiliser le Custom HTML d'Upcart ?
</div>

1. Accédez à **Upcart → Settings → Custom HTML**
2. Utilisez des scripts API pour modifier le comportement du panier, comme le moment d'ouverture ou l'affichage des upsells
3. Ajustez des éléments en dehors d'Upcart, comme masquer les boutons de la page produit

<div id="example-hide-the-sticky-cart-button-when-the-cart-is-empty">
  #### 💡 *Exemple : masquer le bouton de panier flottant lorsque le panier est vide*
</div>

```
<script>  
  window.upcartSubscribeCartLoaded((event) => {  
    const itemCount = event.cart.items.reduce((total, item) => total + item.quantity, 0);  
    document.querySelector("#upCartStickyButton").style.display = itemCount === 0 ? "none" : "block";  
    console.log("Sticky Cart is hiding!");  
  });  
</script>
```

<Note>
  **Note sur l'ancienne version :** les callbacks `window.upcartOnCartLoaded` fonctionnent toujours, mais ils sont obsolètes et affichent des avertissements dans la console. Utilisez `upcartSubscribeCartLoaded` pour tous les nouveaux scripts. Notez que `event.cart` ne possède pas de propriété `item_count` — utilisez `event.cart.items.reduce((total, item) => total + item.quantity, 0)` pour calculer le nombre total d'articles.
</Note>

***

<div id="do-i-need-to-be-a-developer-to-use-upcarts-api">
  # **Dois-je être développeur pour utiliser l'API d'Upcart ?**
</div>

Non ! L'API d'Upcart est facile à utiliser, même sans compétences en programmation. De nombreuses fonctionnalités sont intégrées, et notre [documentation de personnalisation](/fr/upcart/add_a_mandatory_terms_and_conditions_checkbox_to_your_cart) inclut des scripts prérédigés que vous pouvez copier dans les paramètres Custom HTML d'Upcart — aucun codage requis !

Si vous souhaitez écrire des scripts personnalisés, des connaissances de base en JavaScript sont utiles. Si vous débutez en JavaScript, pas d'inquiétude ! Ces ressources adaptées aux débutants — **W3Schools** et **[MDN Web Docs](https://developer.mozilla.org/en-US/docs/Web/JavaScript)** — peuvent vous aider à démarrer.

***

<div id="can-upcarts-api-integrate-with-other-third-party-apps">
  # L'API d'Upcart peut-elle s'intégrer à d'autres applications tierces ?
</div>

Oui ! L'API d'Upcart fonctionne avec des applications de traduction, d'analytique, d'upsell, et plus encore. Certaines s'intègrent automatiquement, tandis que d'autres peuvent nécessiter un petit script.

Par exemple, si vous utilisez **[TripleWhale](https://kb.triplewhale.com/en/articles/6610178-adding-the-triple-pixel-to-third-party-checkouts#h_eccf979512)** pour le suivi, vous devrez ajouter le script suivant pour vous assurer qu'il enregistre correctement l'activité du panier :

```
<script>  
window.upcartSubscribeAddedToCart((event) => {  
	window.TriplePixel('AddToCart', {item: event.item.variantId, q: event.item.quantityAdded});  
});  
</script>
```

<Note>
  **Note sur l'ancienne version :** les callbacks `window.upcartOnAddToCart` fonctionnent toujours, mais ils sont obsolètes et affichent des avertissements dans la console. Utilisez `upcartSubscribeAddedToCart` pour tous les nouveaux scripts. Notez que les propriétés de l'événement se trouvent sur `event.item` (avec `variantId` et `quantityAdded`), et ne sont pas transmises comme paramètres séparés.
</Note>

Comme chaque application est différente, consultez l'équipe d'assistance de votre application pour savoir si du code supplémentaire est nécessaire. Upcart n'offre pas d'assistance pour les scripts des applications tierces, mais votre fournisseur d'application peut avoir un guide d'intégration.

***

<div id="how-do-i-test-if-my-api-changes-are-working">
  # Comment tester si mes modifications d'API fonctionnent ?
</div>

Après avoir ajouté un script dans les paramètres Custom HTML d'Upcart, suivez ces étapes pour vous assurer qu'il fonctionne :

1. **Actualisez votre boutique** et ajoutez un article au panier.

2. **Videz votre cache** et réessayez pour voir les dernières modifications.

3. **Ajoutez un message de test** : insérez `console.log("The script works!");` avant `</script>` pour vérifier si votre script s'exécute.

4. Vérifiez la console de votre navigateur :

   * Ouvrez les **Dev Tools** (`F12` ou `Ctrl + Shift + J` sous Windows, `Cmd + Option + J` sur Mac).
   * Allez dans l'onglet **Console** et cherchez **"The script works!"**
   * Si vous voyez le message, votre script s'exécute ! Sinon, le script ne s'exécute peut-être pas correctement.

5. **Testez différentes actions** (par exemple, la suppression d'un article) pour vous assurer du comportement attendu.

**Résolvez les problèmes** en vérifiant les fautes de frappe ou les erreurs de console et en ajustant le code au besoin.

***

<div id="what-should-i-do-if-an-api-script-isnt-working">
  # Que faire si un script API ne fonctionne pas ?
</div>

Si votre script API ne fonctionne pas, essayez ces étapes de dépannage :

* **Vérifiez les fautes de frappe** – Même de petites erreurs peuvent casser un script. Cherchez des caractères manquants ou une syntaxe incorrecte.

* **Vérifiez l'emplacement du script** – Assurez-vous que le script se trouve dans la bonne section sous Upcart → Settings → Custom HTML. Upcart comporte dix sections de scripts (neuf points d'injection HTML plus une section Scripts-before-load) — [Consultez ces sections ici.](/fr/upcart/custom_html)

* **Vérifiez la console du navigateur** – Suivez les étapes ci-dessus pour rechercher des erreurs.

* **Testez un autre script** – Essayez un autre script API Upcart prérédigé pour voir si le problème vient de votre code.

* **Toujours bloqué ?** – Si vous modifiez votre thème Shopify ou intégrez des applications tierces, un expert Shopify du [Shopify Partner Directory](https://www.shopify.com/partners/directory) peut vous aider.

Ces étapes devraient vous aider à identifier et résoudre la plupart des problèmes de scripts !

***

<div id="how-do-i-undo-changes-if-i-add-a-script-that-breaks-something">
  # Comment annuler des modifications si j'ajoute un script qui casse quelque chose ?
</div>

Si vous ajoutez un script qui ne fonctionne pas comme prévu, vous pouvez **facilement le supprimer ou le désactiver** :

* **Allez dans les paramètres Custom HTML d'Upcart** où le script a été ajouté.

* **Supprimez le script** ou désactivez-le temporairement en ajoutant `//` au début de chaque ligne (cela le transforme en commentaire, l'empêchant de s'exécuter).

* **Enregistrez les modifications et actualisez votre boutique** pour vérifier si le problème est résolu.

Si le problème persiste, essayez de vider votre cache ou d'annuler les modifications récentes du thème — cela résout souvent des conflits cachés.

***

🚧 **Vous recherchez des personnalisations avancées ?**

Vous avez besoin de personnalisations à l'échelle de la boutique ou d'intégrations avec des applications tierces ? Vous aurez peut-être besoin d'un développeur pour ajouter l'API d'Upcart à votre thème Shopify.

Envisagez d'embaucher un expert Shopify via le **[Shopify Partner Directory](https://www.shopify.com/partners/directory)** et partagez avec lui notre [documentation API](/fr/upcart/introduction_to_upcarts_public_api) pour obtenir de l'aide