> ## 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 boutiques (Economy héritée)

> Démarrage rapide pour créer des boutiques PlayFab Legacy Economy (v1), y ajouter des articles, définir des prix propres à la boutique et afficher les boutiques aux joueurs en jeu.

# Démarrage rapide des boutiques (Economy héritée)

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

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

Comme indiqué dans le [démarrage rapide des articles](/fr/services/playfab/economy-monetization/economy/items/quickstart), PlayFab prend en charge l'achat d'articles 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 (idle clicker), un RPG, un FPS ou un runner sans fin, votre jeu comporte probablement des vendeurs : des lieux où les joueurs peuvent acheter des armes, des armures ou des chaussures de course.

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

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

* Ajouter des articles à un catalogue avec des prix normaux.
* Créer une boutique contenant les mêmes articles à prix réduits.
* Utiliser les API PlayFab pour acheter un article dans la boutique.
* Utiliser les informations de Game Manager pour confirmer que l'article a été acheté au prix réduit de la boutique.

## Ajout d'articles à un catalogue

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

1. Ouvrez **Game Manager** et sélectionnez **Economy** dans la barre latérale gauche.
2. Sélectionnez l'onglet **Catalogs** et ouvrez votre catalogue **main**.
3. Sélectionnez **New Item** plusieurs fois et créez quelques articles :
   * **apricot** avec un prix de **4** **GD**.
   * **pear** avec un prix de **3** **GD**.
   * **grape** sans prix en **GD** (ne sélectionnez aucun prix).

<Tip>
  Il n'est pas nécessaire d'attribuer un prix en monnaie virtuelle aux articles d'un catalogue pour qu'ils apparaissent dans une boutique.
</Tip>

Dans l'exemple suivant, un article appelé **apricot** est ajouté au catalogue **main** avec un 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'une boutique

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

1. Ouvrez votre catalogue **main** et sélectionnez **Stores**.
2. Sélectionnez **New store**.
3. Définissez **Store Id** et **Store name** sur **fruits** (comme illustré 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, semblable à celle illustrée ci-dessous, affiche tous les articles, bundles et conteneurs du catalogue actuel.
5. Ajoutez quelques articles à votre boutique en sélectionnant le bouton **Add** en regard de chaque article.
   <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 boutique d'un article

Vos articles devraient maintenant apparaître dans **STORE CONTENTS**, mais ils ne sont valides que s'ils ont 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 besoin de saisir un prix que dans *une* zone par ligne, mais vous pouvez en saisir autant que vous le souhaitez.

* Si vous ne saisissez aucun prix pour un article, celui-ci sera retiré de la boutique.
* Si un article de la boutique n'a pas de prix dans une monnaie, il ne peut pas être acheté avec cette monnaie.
* Les prix en boutique peuvent être supérieurs aux prix du catalogue, et zéro est un prix valide pour un article.

<Tip>
  Vous pouvez faire glisser-déplacer les lignes du contenu de la boutique pour réorganiser l'ordre des articles.
</Tip>

1. Ajoutez des prix en **GD** à vos articles, 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 article appelé **apricot**, dont le prix catalogue est de **4 GD**, reçoit un prix en boutique 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 une boutique" width="1280" height="900" data-path="images/playfab/economy-monetization/economy/tutorials/game-manager-economy-catalogs-stores-set-price.png" />

## Achat d'un article dans la boutique

Maintenant que vous disposez d'une boutique, utilisons les API PlayFab pour acheter un article de la boutique dans votre jeu.

1. Obtenez votre boutique 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 articles de votre boutique et leurs prix.
3. Appelez [PurchaseItem](xref:titleid.playfabapi.com.client.playeritemmanagement.purchaseitem) avec des valeurs dans la requête qui spécifient la monnaie et le prix en boutique de l'article que vous souhaitez acheter.
   * `CatalogVersion = "main"`
   * `StoreId = "fruits"`
   * `ItemId = "pear"`
   * `VirtualCurrency = "GD"`
   * `Price = 2`

<Tip>
  Si vous ne spécifiez pas le **`StoreId`** lors de l'appel de [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 boutique 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'article.
3. Vérifiez les informations suivantes pour le joueur :
   * Ouvrez l'onglet **Inventory**. L'inventaire devrait maintenant contenir une **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 montrant le flux d'achat depuis la boutique. Ces événements incluent un événement [Player virtual currency item purchased](/fr/services/playfab/api-references/events/Player/player-vc-item-purchased) et un événement [Player virtual currency balance changed](/fr/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 articles de votre boutique et ajuster les prix à tout moment.
</Tip>

## Étapes suivantes

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

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

* [Boutiques personnalisées pour les segments de joueurs](/fr/services/playfab/economy-monetization/economy/tutorials/custom-stores-for-player-segments)
* [Bonnes pratiques pour la segmentation des boutiques](/fr/services/playfab/economy-monetization/economy/tutorials/best-practices-for-store-segmentation)


## Related topics

- [Démarrage rapide d'Economy (héritée)](/fr/services/playfab/economy-monetization/economy/quickstart.md)
- [Démarrage rapide des articles (Economy héritée)](/fr/services/playfab/economy-monetization/economy/items/quickstart.md)
- [Démarrage rapide des monnaies virtuelles Economy v2](/fr/services/playfab/economy-monetization/economy-v2/tutorials/currencies.md)
- [Catalogues (Economy héritée)](/fr/services/playfab/economy-monetization/economy/items/catalogs.md)
- [Boutiques (Economy héritée)](/fr/services/playfab/economy-monetization/economy/stores/index.md)