{"templateId":"openapi_docs","sharedDataIds":{"openAPIDocsStore":"oas-@l10n/fr/api/catalog/index.yaml","sidebar":"sidebar-@l10n/fr/catalog-en.sidebars.yaml"},"props":{"definitionId":"@l10n/fr/api/catalog/index.yaml","dynamicMarkdocComponents":[],"baseSlug":"/fr/api/catalog","seo":{"title":"Aperçu","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]},"description":"Le panier est un mécanisme d'achat qui permet de regrouper plusieurs objets dans une seule commande. Un utilisateur peut acheter des objets de tout type et en toute quantité avec de la devise réelle, ainsi qu'utiliser des [codes promo](https://developers.xsolla.com/fr/api/liveops/promotions-promo-codes).\n\nLe panier est stocké côté Xsolla. Sa sauvegarde d'une session à une autre dépend de l'authentification :\n  * pour les utilisateurs authentifiés, le panier est lié à un utilisateur et conservé entre les sessions tant que les requêtes sont effectuées au nom de ce même utilisateur.\n\n  * Pour les [utilisateurs non authentifiés](/fr/api/catalog/section/authentication/authentication-with-guest-access-support), la sauvegarde du panier dépend de la transmission de l'en-tête `x-unauthorized-id`. Pour conserver le panier d'un utilisateur non authentifié d'une session à l'autre, passez le même `x-unauthorized-id` dans chaque requête. Cette option est disponible uniquement pour la vente de clés de jeu.\n\nVous pouvez identifier le panier de deux façons : automatiquement via le [JWT utilisateur](https://developers.xsolla.com/fr/api/catalog/section/authentication/authentication-using-user's-jwt) ou via l'ID du panier (`cart_id`).\n\nLa gestion du panier est disponible à la fois côté client et côté serveur.\n\nCôté serveur, vous pouvez remplir le panier avec des objets, par exemple lors de la restauration d'une session utilisateur. Les actions suivantes sont disponibles côté client :\n\n* récupérer le panier de l'utilisateur actuel ou un panier par ID\n* remplir le panier\n* mettre à jour les objets dans le panier\n* supprimer des objets du panier\n\nPour acheter des objets du panier, les appels client et serveur servent à créer une commande.\n\nLa durée de vie (TTL) du panier est de 72 heures par défaut. Si son contenu change, par exemple lorsqu'un nouvel objet est ajouté, la TTL est prolongée.\n\nAprès un paiement réussi, le panier n'est pas vidé automatiquement. Pour le vider, utilisez les appels API côté client suivants :\n  * [Supprimer tous les objets du panier par ID de panier](/fr/api/catalog/cart-client-side/cart-clear-by-id).\n\n  * [Supprimer tous les objets du panier actuel](/fr/api/catalog/cart-client-side/cart-clear).\n\n  * [Supprimer un objet du panier par ID de panier](/fr/api/catalog/cart-client-side/delete-item-by-cart-id) et [Supprimer un objet du panier actuel](/fr/api/catalog/cart-client-side/delete-item) — le panier est vidé lorsque vous supprimez le dernier objet.\n\nScénario d'utilisation du panier :\n\n1. Implémentez une interface de magasin permettant à l'utilisateur de sélectionner des objets.\n\n2. Lorsque l'utilisateur sélectionne des objets dans le magasin, ajoutez-les au panier, par exemple via l'appel [Remplir le panier d'objets](https://developers.xsolla.com/fr/api/catalog/cart-client-side/cart-fill). Dans le tableau des objets, indiquez les UGS et les quantités requises pour chaque objet.\n\n3. Implémentez l'interface du panier. Lors de l'accès au panier, affichez son contenu via l'appel [Lire le panier de l'utilisateur actuel](https://developers.xsolla.com/fr/api/catalog/cart-client-side/get-user-cart). La réponse inclut des informations sur le prix final de l'objet, avec remises et promotions appliquées.\n\n4. Implémentez l'ouverture de l'interface de paiement pour régler la commande. Vous pouvez, par exemple, utiliser l'appel [Créer une commande à partir de tous les objets d'un panier spécifique](https://developers.xsolla.com/fr/api/catalog/payment-client-side/create-order-by-cart-id). La réponse renvoie un jeton permettant d'ouvrir l'interface de paiement.\n\n5. Configurez le suivi du statut des commandes, par exemple à l'aide des [webhooks](https://developers.xsolla.com/fr/webhooks/), afin de recevoir rapidement les informations sur les objets payés avec succès et de les attribuer à l'utilisateur.\n\n<div class=\"note\">\n  <p><b>Note</b></p>\n  <p>Pour implémenter la vente d'objets en jeu et en ligne, consultez le <a href=\"https://developers.xsolla.com/fr/virtual-goods/own-ui/\">guide d'intégration</a>.</p>\n</div>\n\n![Flux de panier et de paiement](https://cdn.xsolla.net/developers/current/images/api_docs/cart-payment-flow.svg)"},"itemId":"cart-and-payment-overview","disableAutoScroll":true,"metadata":{},"compilationErrors":[],"markdown":{"partials":{},"variables":{"rbac":{"teams":["anonymous"]},"user":{},"remoteAddr":{"hostname":"xsolla.redocly.app","port":4000,"ipAddress":"216.73.216.177"},"lang":"fr","env":{"PUBLIC_REDOCLY_BRANCH_NAME":"realm"}}},"pagePropGetterError":{"message":"","name":""}},"slug":"/fr/api/catalog/cart-and-payment-overview","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}