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

# Démarrage rapide des magasins (Economy hérité)

> Démarrage rapide pour créer des magasins PlayFab Economy hérité (v1), ajouter des objets, définir des prix propres au magasin et présenter les magasins aux joueurs en jeu.

# Démarrage rapide des magasins (Economy hérité)

<Info>
  Les API Economy v1 sont en mode maintenance et ne recevront aucune nouvelle fonctionnalité, seulement des correctifs de bogues. **Les API v1 seront maintenues dans un avenir prévisible.** Consultez la [vue d'ensemble d'Economy v2](/fr-CA/services/playfab/economy-monetization/economy-v2/overview) pour en savoir plus sur la prochaine version de PlayFab Economy!
</Info>

Les magasins sont le meilleur moyen de permettre aux joueurs d'acheter des objets dans votre jeu.

Comme le montre le [démarrage rapide des objets](/fr-CA/services/playfab/economy-monetization/economy/items/quickstart), PlayFab prend en charge l'achat d'objets directement dans un catalogue, mais ce n'est pas ainsi que la plupart des jeux structurent leurs achats. Que vous créiez un jeu incrémental, un RPG, un FPS ou un jeu de course sans fin, vous avez probablement des vendeurs dans votre jeu. Des endroits où les joueurs peuvent acheter des armes, des armures ou des chaussures de course.

Notre solution pour les vendeurs et les boutiques en jeu est celle des magasins, un sous-ensemble de votre catalogue dont vous pouvez remplacer les prix.

Dans ce démarrage rapide des magasins, vous allez :

* Ajouter des objets à un catalogue avec des prix réguliers.
* Créer un magasin contenant les mêmes objets à prix réduits.
* Utiliser les API PlayFab pour acheter un objet du magasin.
* Utiliser l'information de Game Manager pour confirmer que l'objet a été acheté au prix réduit du magasin.

## Ajout d'objets à un catalogue

Commençons par ajouter quelques objets à vendre dans votre catalogue :

1. Ouvrez **Game Manager** et sélectionnez **Economy** dans la barre latérale gauche.
2. Sélectionnez l'onglet **Catalogs**, puis ouvrez votre catalogue **main**.
3. Sélectionnez **New Item** à quelques reprises pour créer des objets :
   * **apricot** au prix de **4** **GD**.
   * **pear** au prix de **3** **GD**.
   * **grape** sans prix en **GD** (ne sélectionnez aucun prix).

<Tip>
  Vous n'avez pas à attribuer un prix en monnaie virtuelle aux objets d'un catalogue pour qu'ils apparaissent dans un magasin.
</Tip>

Dans l'exemple suivant, un objet appelé **apricot** est ajouté au catalogue **main** au prix de **4** **GD**.

<img src="https://mintcdn.com/microsoft-4404708b/Oa_DP1q6U1lat7c2/images/playfab/economy-monetization/economy/tutorials/game-manager-economy-catalogs-add-item.png?fit=max&auto=format&n=Oa_DP1q6U1lat7c2&q=85&s=974c10b2f774db3364e1e8c17690dbc1" alt="Economy - Catalogs - Add Item" width="1280" height="900" data-path="images/playfab/economy-monetization/economy/tutorials/game-manager-economy-catalogs-add-item.png" />

## Création d'un magasin

Vous devriez maintenant avoir quelques objets avec des prix dans votre catalogue. Créons un magasin pour les vendre à un joueur.

1. Ouvrez votre catalogue **main** et sélectionnez **Stores**.
2. Sélectionnez **New store**.
3. Réglez **Store Id** et **Store name** à **fruits** (comme dans l'exemple suivant).
   <img src="https://mintcdn.com/microsoft-4404708b/Oa_DP1q6U1lat7c2/images/playfab/economy-monetization/economy/tutorials/game-manager-economy-catalogs-stores-new-store.png?fit=max&auto=format&n=Oa_DP1q6U1lat7c2&q=85&s=bbf8142167e24b8043ed9c17b8a88cbe" alt="Economy - Catalogs - Stores - New Store" width="1280" height="900" data-path="images/playfab/economy-monetization/economy/tutorials/game-manager-economy-catalogs-stores-new-store.png" />
4. Sélectionnez **ADD TO STORE**.
   * Une fenêtre contextuelle, comme celle illustrée ci-dessous, affiche tous les objets, ensembles et conteneurs du catalogue actuel.
5. Ajoutez quelques objets à votre magasin en sélectionnant le bouton **Add** à côté de l'objet.
   <img src="https://mintcdn.com/microsoft-4404708b/Oa_DP1q6U1lat7c2/images/playfab/economy-monetization/economy/tutorials/game-manager-economy-catalogs-stores-add-to-store.png?fit=max&auto=format&n=Oa_DP1q6U1lat7c2&q=85&s=7493d74a40355bb7b89322b4d3d74889" alt="Economy - Catalogs - Stores - Add To Store" width="1280" height="900" data-path="images/playfab/economy-monetization/economy/tutorials/game-manager-economy-catalogs-stores-add-to-store.png" />

## Définition du prix en magasin d'un objet

Vos objets devraient maintenant figurer dans **STORE CONTENTS**, mais ils ne sont pas valides tant qu'ils n'ont pas au moins un prix.

Le petit nombre statique (par exemple, **\< 4**) à côté de la zone de texte du prix correspond au prix d'origine du catalogue. Vous n'avez à entrer un prix que dans *une seule* zone de chaque ligne, mais vous pouvez entrer autant de prix que vous le souhaitez.

* Si vous n'entrez aucun prix pour un objet, celui-ci sera retiré du magasin.
* Si un objet du magasin n'a pas de prix dans une monnaie, il ne peut pas être acheté avec cette monnaie.
* Les prix en magasin peuvent être plus élevés que les prix du catalogue, et zéro est un prix valide pour un objet.

<Tip>
  Vous pouvez glisser-déposer les lignes du contenu du magasin pour réorganiser l'ordre des objets.
</Tip>

1. Ajoutez des prix en **GD** à vos objets, mais inférieurs aux prix du catalogue :
   * **Apricot : 3**.
   * **Pear : 2**.
   * **Grape : 1**.
2. Sélectionnez **SAVE STORE** lorsque vous avez terminé.

Dans l'exemple suivant, un objet appelé **apricot** dont le prix au catalogue est de **4 GD** reçoit un prix en magasin de **3 GD**.

<img src="https://mintcdn.com/microsoft-4404708b/Oa_DP1q6U1lat7c2/images/playfab/economy-monetization/economy/tutorials/game-manager-economy-catalogs-stores-set-price.png?fit=max&auto=format&n=Oa_DP1q6U1lat7c2&q=85&s=e8b18e16d87da6105ceda47afe2ea56f" alt="Créer un magasin" width="1280" height="900" data-path="images/playfab/economy-monetization/economy/tutorials/game-manager-economy-catalogs-stores-set-price.png" />

## Achat d'un objet dans le magasin

Maintenant que vous avez un magasin, utilisons les API PlayFab pour acheter un objet du magasin dans votre jeu.

1. Obtenez votre magasin en appelant [GetStoreItems](xref:titleid.playfabapi.com.client.title-widedatamanagement.getstoreitems) avec ces paramètres dans la requête :
   * `CatalogVersion = "main"`
   * `StoreId = "fruits"`
2. Le champ `Store` de [GetStoreItemsResult](xref:titleid.playfabapi.com.client.title-widedatamanagement.getstoreitems#getstoreitemsresult) devrait contenir la liste des objets de votre magasin et leurs prix.
3. Appelez [PurchaseItem](xref:titleid.playfabapi.com.client.playeritemmanagement.purchaseitem) avec, dans la requête, des valeurs qui précisent la monnaie et le prix en magasin de l'objet que vous souhaitez acheter.
   * `CatalogVersion = "main"`
   * `StoreId = "fruits"`
   * `ItemId = "pear"`
   * `VirtualCurrency = "GD"`
   * `Price = 2`

<Tip>
  Si vous ne précisez pas le **`StoreId`** lors de l'appel à [PurchaseItem](xref:titleid.playfabapi.com.client.playeritemmanagement.purchaseitem), l'achat est tenté au prix du catalogue.
</Tip>

## Confirmation du prix d'achat

Ouvrez Game Manager et confirmez que l'achat a été effectué au prix en magasin de deux GD.

1. Sélectionnez **Players** dans la barre latérale gauche pour ouvrir l'onglet **Players**.
2. Sélectionnez l'**ID** du joueur qui a acheté l'objet.
3. Vérifiez l'information suivante pour le joueur :
   * Ouvrez l'onglet **Inventory**. L'inventaire devrait maintenant contenir un objet **pear**.
   * Ouvrez l'onglet **Virtual Currency**. Vérifiez la valeur **Amount** de la monnaie virtuelle pour confirmer que le joueur n'a dépensé que 2 GD.
   * Ouvrez l'onglet **PlayStream**. Vous verrez des événements illustrant le flux d'achat à partir du magasin. Ces événements comprennent un événement [Player virtual currency item purchased](/fr-CA/services/playfab/api-references/events/Player/player-vc-item-purchased) et un événement [Player virtual currency balance changed](/fr-CA/services/playfab/api-references/events/Player/player-virtual-currency-balance-changed) indiquant que le solde de monnaie virtuelle a changé de deux GD.

<Tip>
  Vous pouvez utiliser Game Manager pour modifier l'ordre des objets de votre magasin et ajuster les prix en tout temps.
</Tip>

## Étapes suivantes

Maintenant que vous savez comment créer et utiliser des magasins dans votre jeu, vous êtes prêt à explorer des utilisations plus avancées des magasins.

Par exemple, en utilisant des segments avec des magasins, vous pouvez offrir des prix spéciaux à certains joueurs sans toucher au code de votre jeu.

* [Magasins personnalisés pour des segments de joueurs](/fr-CA/services/playfab/economy-monetization/economy/tutorials/custom-stores-for-player-segments)
* [Meilleures pratiques de segmentation des magasins](/fr-CA/services/playfab/economy-monetization/economy/tutorials/best-practices-for-store-segmentation)


## Related topics

- [Démarrage rapide d'Economy (hérité)](/fr-CA/services/playfab/economy-monetization/economy/quickstart.md)
- [Démarrage rapide des objets (Economy hérité)](/fr-CA/services/playfab/economy-monetization/economy/items/quickstart.md)
- [Catalogues (Economy hérité)](/fr-CA/services/playfab/economy-monetization/economy/items/catalogs.md)
- [Magasins (Economy hérité)](/fr-CA/services/playfab/economy-monetization/economy/stores/index.md)
- [Démarrage rapide](/fr-CA/services/playfab/economy-monetization/economy-v2/quickstart.md)