> ## 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 de la prévention de la fraude

> Guide de démarrage rapide pour activer la validation des reçus et la prévention de la fraude dans PlayFab Economy v2 pour le Microsoft Store, iOS, Google Play et d'autres plateformes.

<Info>
  Economy v2 est maintenant en disponibilité générale. Pour obtenir du soutien et transmettre vos commentaires, rendez-vous sur le [forum PlayFab](https://community.playfab.com).
</Info>

Ce démarrage rapide vous permettra de mettre en place la validation des reçus dans le Microsoft Store ([Windows 10/11](https://learn.microsoft.com/en-us/windows/uwp/publish/), [XBOX](https://learn.microsoft.com/en-us/gaming/xbox/), [Android](https://blogs.windows.com/windows-insider/2021/10/20/announcing-android-apps-on-windows-11-preview-for-windows-insiders-in-the-beta-channel/)).

## Prérequis

Le [démarrage rapide de PlayFab Economy v2](/fr-CA/services/playfab/economy-monetization/economy-v2/quickstart) vous permettra de tout configurer pour effectuer la validation des reçus.

## Validation des reçus du marketplace Microsoft Store

* [GetMicrosoftStoreAccessTokens](https://learn.microsoft.com/en-us/rest/api/playfab/economy/inventory/get-microsoft-store-access-tokens)
* [RedeemMicrosoftStoreInventoryItems](https://learn.microsoft.com/en-us/rest/api/playfab/economy/inventory/redeem-microsoft-store-inventory-items)

Pour utiliser l'API Redeem, vous commencez par configurer vos ID de produits et vos prix dans le marketplace que vous utilisez (Apple Store, Steam, Google Play, etc.). Au départ, tous les produits sont anonymes, c'est-à-dire des entrées numériques que votre joueur peut acheter, mais qui n'ont aucune signification dans PlayFab.

Pour donner une signification à ces entrées, nous devons les reproduire dans le catalogue PlayFab. Cette reproduction transformera les entités anonymes en ensembles de catalogue. Lorsque vous appelez `RedeemMicrosoftStoreInventoryItems` dans le nouveau service, nous recherchons dans le catalogue un ensemble correspondant à accorder à l'inventaire virtuel de l'entité joueur.

Chaque ensemble peut être lié à un ou plusieurs produits de marketplaces partenaires en lui ajoutant un AlternateId. L'AlternateId est le lien entre PlayFab et tout marché IAP externe. Lorsque votre titre appelle Redeem pour une entité joueur donnée, nous transmettons cet ID au marché IAP pour vérification. Le flux général est le suivant :

1. Créez une offre en argent réel (ou plus) dans le Microsoft Store
2. Renseignez les modules complémentaires dans PlayFab avec les autorisations d'appel du marché IAP et créez dans PlayFab les ensembles correspondants liés aux offres que vous avez créées
3. Appelez `RedeemMicrosoftStoreInventoryItems`

<Note>
  Contrairement aux versions précédentes de PlayFab, dans le nouveau système, vous créez simplement une seule offre d'ensemble, puis vous ajoutez chaque SKU de marché qui doit y faire référence dans la liste AlternateId. Vous n'avez pas besoin de créer un nouvel article pour chaque marché IAP.
</Note>

### Étape 1 - Configurer votre intégration de marketplace

Vous devez configurer chaque intégration de marché IAP dans GameManager, sous la section Add-ons, pour permettre à PlayFab d'appeler le marché au nom du titre.

### Étape 2 - Créer un ensemble pour la validation des reçus

Vous pouvez [créer un ensemble](/fr-CA/services/playfab/economy-monetization/economy-v2/catalog/bundles) dans GameManager ou en appelant `CreateDraftItem`. Au minimum, un ensemble exige un titre, une description et des articles. Dans GameManager, vous pouvez lier des entrées de marketplace à l'aide de la section Marketplace Mapping.

Si vous créez l'ensemble à l'aide de l'API, vous devez ajouter vos mappages de marketplaces IAP sous la section alternateIds d'un ensemble. Les énumérations de marketplaces sont précises et sensibles à la casse; vous devez utiliser l'un des modules complémentaires suivants :

* Apple = "AppleAppStore"
* Google Play = "GooglePlay"
* Nintendo = "NintendoEShop"
* Microsoft = "MicrosoftStore"
* PlayStation = "PlayStationStore"
* Steam = "Steam"

### Étape 3 - Appeler Redeem à partir de votre jeu

Votre jeu appelle l'API `RedeemMicrosoftStoreInventoryItems` avec les détails de l'entité et du reçu pour « échanger » l'offre en argent réel et remplir l'inventaire de l'entité correspondante. Vous devez fournir quelques éléments dans l'appel pour qu'il fonctionne correctement :

* Obligatoire dans l'en-tête de la requête
  * X-EntityToken - Le jeton qui identifie de façon unique une entité PlayFab
  * Content-Type - Application/Json
* Obligatoire dans le corps de la requête
  * `CollectionsIdKey`

Chaque marché IAP a des exigences légèrement différentes pour effectuer ces appels. Par exemple, pour les achats Apple et GooglePlay, vous devez joindre un reçu du marketplace.

Lorsque votre client de jeu démarre, lancez d'abord un appel Redeem PlayFab pour le marketplace. Les appels Redeem permettent à PlayFab de se synchroniser avec tout achat éventuel effectué hors ligne ou en dehors du jeu.  Votre jeu devrait utiliser ces appels chaque fois qu'un achat dans le jeu d'une offre de marketplace a lieu.

Redeem garantit que la devise de l'inventaire de l'entité joueur est renseignée après l'appel du point de terminaison Redeem.

## Partie 4 : Acheter un article

### Game Manager

Vous pouvez vérifier que des articles ou des devises existent dans les vues individuelles des joueurs. Dans GameManager, sélectionnez Players, puis accédez à une entité joueur individuelle. Utilisez les onglets Inventory pour afficher et mettre à jour ce que possède cette entité joueur.

### API

Dans votre jeu, connectez-vous en tant que joueur ayant reçu de la devise virtuelle.

Appelez `SearchItems` pour utiliser un itemId de catalogue publié précédemment.

Appelez `PurchaseInventoryItems` avec l'itemId de l'article du catalogue et l'ID de la devise virtuelle accordée.

Enfin, appelez `GetInventoryItems` et consultez le résultat de cette méthode.

***

Pour en savoir plus sur la monétisation sur la plateforme Microsoft, cliquez [ici](https://learn.microsoft.com/en-us/windows/uwp/monetize/).


## Related topics

- [Échange avec la place de marché Steam](/fr-CA/services/playfab/economy-monetization/economy-v2/marketplace/marketplace-redemption/steam.md)
- [Prix en argent réel dans Economy v2](/fr-CA/services/playfab/economy-monetization/economy-v2/catalog/real-money-prices.md)
- [Suivi des prix en argent réel dans Economy v2](/fr-CA/services/playfab/economy-monetization/economy-v2/tutorials/real-money-price-tracking.md)
- [Ensembles d'Economy v2](/fr-CA/services/playfab/economy-monetization/economy-v2/catalog/bundles.md)
- [Prévention de la fraude, échange, validation des reçus](/fr-CA/services/playfab/economy-monetization/economy-v2/fraud-prevention/index.md)
