> ## 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 des fraudes

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

<Info>
  Economy v2 est désormais en disponibilité générale. Pour obtenir de l'aide et donner votre avis, rendez-vous sur le [forum PlayFab](https://community.playfab.com).
</Info>

Ce démarrage rapide vous permet de mettre en place la validation des reçus sur 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/services/playfab/economy-monetization/economy-v2/quickstart) vous permet de tout configurer pour effectuer la validation des reçus.

## Validation des reçus sur la place de marché 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, commencez par configurer vos ID de produit et vos prix sur la place de marché que vous utilisez (Apple Store, Steam, Google Play, etc.). Au départ, tous les produits sont anonymes : ce sont 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 refléter dans le catalogue PlayFab. Cette mise en miroir transforme les entités anonymes en lots de catalogue. Lorsque vous appelez `RedeemMicrosoftStoreInventoryItems` dans le nouveau service, nous recherchons dans le catalogue un lot correspondant à accorder à l'inventaire virtuel du joueur (entité).

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

1. Créer une (ou plusieurs) offres en argent réel dans le Microsoft Store
2. Renseigner les extensions dans PlayFab avec les autorisations d'appel de la place de marché IAP, puis créer dans PlayFab les lots correspondants liés aux offres que vous avez créées
3. Appeler `RedeemMicrosoftStoreInventoryItems`

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

### Étape 1 - Configuration de l'intégration de votre place de marché

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

### Étape 2 - Création d'un lot pour la validation des reçus

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

Si vous créez le lot à l'aide de l'API, vous devez ajouter vos mappages de places de marché IAP dans la section alternateIds du lot. Les énumérations de places de marché sont spécifiques et respectent la casse ; vous devez utiliser l'une des extensions suivantes :

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

### Étape 3 - Appel de Redeem depuis 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 alimenter 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 identifiant de manière unique une entité PlayFab
  * Content-Type : Application/Json
* Obligatoire dans le corps de la requête
  * `CollectionsIdKey`

Chaque place de 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 de la place de marché.

Au lancement de votre client de jeu, commencez par lancer un appel Redeem PlayFab pour la place de marché. Les appels Redeem permettent à PlayFab de se synchroniser avec les éventuels achats effectués hors connexion ou en dehors du jeu. Votre jeu doit utiliser ces appels chaque fois qu'un achat en jeu d'une offre de place de marché a lieu.

Redeem garantit que la devise de l'inventaire de l'entité de joueur est renseignée une fois le point de terminaison Redeem appelé.

## Partie 4 : Achat d'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é de joueur individuelle. Utilisez les onglets Inventory pour afficher et mettre à jour ce que possède ce joueur (entité).

### 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 de catalogue et l'ID de la devise virtuelle accordée.

Enfin, appelez `GetInventoryItems` et affichez 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

- [Guía de inicio rápido de prevención de fraude](/es/services/playfab/economy-monetization/economy-v2/fraud-prevention/quickstart.md)
- [Prevención de fraude, canje y validación de recibos](/es/services/playfab/economy-monetization/economy-v2/fraud-prevention/index.md)
- [Vue d'ensemble de l'API C Services - PFPlatformSpecificTypes.h](/fr/services/playfab/api-references/c/pfplatformspecifictypes/pfplatformspecifictypes_members.md)
- [Notes de version du SDK C++ PlayFab Multiplayer](/fr/services/playfab/multiplayer/lobby/lobby-matchmaking-sdks/lobby-and-matchmaking-release-notes.md)
- [PFPlatformSpecificAndroidDevicePushNotificationRegistrationRequest](/fr/services/playfab/api-references/c/pfplatformspecifictypes/structs/pfplatformspecificandroiddevicepushnotificationregistrationrequest.md)
