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

# Vue d'ensemble des systèmes commerciaux du GDK

> Vue d'ensemble des systèmes commerciaux du Microsoft Store disponibles dans le GDK : achats, droits, consommables, DLC, versions d'évaluation, abonnements et API de licence.

Les fonctionnalités et services liés au commerce disponibles dans le GDK permettent de multiples modèles de monétisation ainsi qu'une intégration poussée des services back-end à ces options commerciales. Ce document fournit une vue d'ensemble de ces systèmes et options, qui sont traités plus en détail dans la section Commerce de la documentation du GDK.

## Fonctionnalités côté client

Le GDK permet aux jeux d'implémenter plusieurs types d'extensions et de types de produits dans le jeu, tels que les consommables, les durables (contenu téléchargeable), les abonnements, les bundles et les versions d'évaluation. L'ensemble d'API XStore fournit les fonctionnalités nécessaires pour interroger, promouvoir et gérer ces produits côté client. Pour un exemple de boutique dans le jeu entièrement fonctionnelle, consultez l'[exemple In-Game Store du GDK](https://github.com/microsoft/Xbox-GDK-Samples/tree/main/Samples/Live/InGameStore).

Les articles suivants de la section Fundamentals traitent de ces API et scénarios :

* [Opérations de base du Store](/fr/publishing/xstore-commerce/xstore-basic-operations) - Interroger ce qui est disponible à la vente et ce que possède l'utilisateur
* [Comment utiliser un durable sans package](/fr/publishing/xstore-commerce/xstore-dwob) - Utilisation d'un durable qui n'a pas de package de téléchargement distinct.
* [Gérer et accorder une licence au contenu téléchargeable (DLC)](/fr/publishing/xstore-commerce/xstore-dlc) - Utilisation de durables traditionnels avec des packages de téléchargement.
* [Écosystèmes basés sur les consommables](/fr/publishing/xstore-commerce/xstore-consumables) - Mise en place et configuration d'un modèle de monétisation basé sur les consommables dans votre jeu.
* [Implémentation de versions d'évaluation pour votre jeu](/fr/publishing/xstore-commerce/xstore-trials) - Implémentation d'une version d'évaluation intégrée à votre jeu.
* [Bundles et Season Pass](/fr/publishing/xstore-commerce/xstore-bundles-season-passes) - Utilisation de bundles et de Season Pass pour apporter de la valeur et de l'engagement aux clients avec vos produits.
* [Modèle de partage de produits pour les jeux](/fr/publishing/xstore-commerce/xstore-product-sharing) - Le modèle de licence des jeux GDK sur console XBOX et PC Windows, et la façon dont le partage entre utilisateurs s'applique.

## Fonctionnalités côté serveur

Les services du Microsoft Store qui prennent en charge les API côté client et permettent les appels de service à service sont répartis entre les services suivants :

* [Collections](/fr/publishing/xstore-commerce/xstore-query-entitlements) - Fournit des informations sur les produits que l'utilisateur possède ou qu'il a le droit d'utiliser, et traite les produits consommables. Peut également servir à détecter l'état de l'abonnement Game Pass pour les partenaires autorisés.
* [Clawback](/fr/publishing/xstore-commerce/xstore-managing-consumables) - Permet aux services partenaires de détecter et de gérer les remboursements accordés aux utilisateurs pour des consommables déjà traités.
* [Purchase](/fr/reference/microsoft-store-apis/xstore-v8-grant) - Permet aux services partenaires d'ajouter des éléments gratuits au compte de l'utilisateur.
* Recurrence - Fournit des informations détaillées sur les abonnements d'un utilisateur et permet aux services partenaires de gérer ces abonnements au nom de l'utilisateur.

### Authentification auprès des services du Microsoft Store

Pour obtenir des informations détaillées sur la façon d'authentifier votre service auprès des services du Microsoft Store, consultez [Demande d'un User Store ID pour l'authentification de service à service](/fr/publishing/xstore-commerce/xstore-requesting-userstoreid).

<Note>
  Si vous connaissez l'authentification par X-token, le service Collections prend en charge les X-tokens.
</Note>

Cependant, les autres services du Microsoft Store ne les prennent pas en charge. En raison des fonctionnalités précieuses offertes par les autres services, nous recommandons désormais aux partenaires de faire passer leurs flux d'authentification de serveur à serveur au flux Microsoft Entra ID et UserStoreId.

Pour simplifier le flux d'authentification et les appels aux services du Microsoft Store, consultez le projet et l'exemple Microsoft.StoreServices sur GitHub. La bibliothèque Microsoft.StoreServices aide à gérer les clés d'authentification et fournit des API wrapper pour appeler les services du Microsoft Store afin de gérer les produits. Le projet d'exemple montre comment un service peut utiliser la bibliothèque Microsoft.StoreServices, une logique d'exemple pour gérer les produits consommables, rapprocher les achats remboursés, renouveler les informations d'identification expirées, et plus encore. Un guide de configuration pas à pas est inclus avec l'exemple pour configurer le service d'exemple sur votre PC ou via Azure.

* [Bibliothèque Microsoft.StoreServices (GitHub)](https://github.com/microsoft/Microsoft-Store-Services)
* [Exemple Microsoft.StoreServices (GitHub)](https://github.com/microsoft/Microsoft-Store-Services-Sample)

## Informations clés pour les développeurs ayant utilisé le XDK

Si vous connaissez les systèmes commerciaux du XDK, les définitions suivantes devraient vous aider à identifier le nom des services équivalents dans le GDK

* **Service Inventory** - Les fonctionnalités du service Inventory du XDK (interrogation de la propriété, traitement des consommables, etc.) sont désormais prises en charge par le service Collections. Cela inclut tous les scénarios de serveur à serveur pour valider la propriété et les quantités de consommables. Bien que les X-tokens utilisés pour Inventory fonctionnent pour appeler Collections, nous recommandons aux partenaires de passer au flux d'authentification par jeton Microsoft Entra ID et User Store ID afin d'utiliser les fonctionnalités étendues des services du Microsoft Store.<br />Exemple : [https://collections.mp.microsoft.com/v8.0/collections/b2bLicensePreview](/fr/reference/microsoft-store-apis/xstore-v8-query-for-products)
* **API client Inventory** - Toutes les fonctionnalités côté client liées à l'interrogation de la propriété des éléments sont désormais gérées par les API XStore.<br />Exemple : [XStoreQueryEntitledProductsAsync](/fr/reference/system/xstore/xstore_members) renvoie les éléments que l'utilisateur actuel a le droit d'utiliser à ce moment-là.
* **API Catalog Browse** - Toutes les fonctionnalités côté client liées à l'interrogation des produits disponibles à l'achat dans le jeu sont désormais gérées par les API XStore. Il n'existe pas d'option de serveur à serveur pour interroger les produits disponibles à la vente dans votre titre.<br />Exemple : [XStoreQueryAssociatedProductsAsync](/fr/reference/system/xstore/xstore_members) renvoie les produits pouvant être vendus dans le cadre d'une boutique dans le jeu.
* **Versions d'évaluation et licences** - Toutes les fonctionnalités côté client liées aux licences d'évaluation font désormais partie des API XStore. Exemple : [XStoreQueryGameLicenseAsync](/fr/reference/system/xstore/xstore_members) renvoie les informations de licence du jeu actuel, y compris les éventuelles informations de licence d'évaluation. Pour pouvoir valider une licence côté client sur votre propre service, consultez [Utilisation des jetons de licence pour valider les licences sur vos services](/fr/publishing/xstore-commerce/xstore-license-tokens).

## Documentation de référence des API

* [XStore (contenu de l'API)](/fr/reference/system/xstore/xstore_members)
  * Fonctions
    * [XStoreQueryEntitledProductsAsync](/fr/reference/system/xstore/xstore_members)
    * [XStoreQueryAssociatedProductsAsync](/fr/reference/system/xstore/xstore_members)
    * [XStoreQueryGameLicenseAsync](/fr/reference/system/xstore/xstore_members)

## Voir aussi

[Configuration initiale dans Partner Center](/fr/publishing/xstore-commerce/xstore-initial-configuration)

[Opérations de base du Store](/fr/publishing/xstore-commerce/xstore-basic-operations)

[Gérer les produits depuis votre service](/fr/publishing/xstore-commerce/xstore-authenticating-service)

[Considérations propres au PC](/fr/publishing/xstore-commerce/xstore-pc)

[Référence de l'API XStore](/fr/reference/system/xstore/xstore_members)


## Related topics

- [Vue d'ensemble du portage](/fr/paths/porting/overview.md)
- [Vue d'ensemble de XBOX Series X|S](/fr/paths/series-xs/overview.md)
- [Vue d'ensemble de l'accessibilité GDK](/fr/build/game-principles/accessibility/accessibility-overview.md)
- [Vue d'ensemble de Godot et des moteurs communautaires](/fr/paths/community-engines/overview.md)
- [Vue d'ensemble d'Unity](/fr/paths/unity/overview.md)