> ## 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 monnaies virtuelles Economy v2

> Créez et configurez votre première monnaie virtuelle PlayFab Economy v2 à l'aide de Game Manager ou des API Catalog avec un jeton d'entité de titre.

# Configurer votre première monnaie virtuelle

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

Prenez en main PlayFab Economy en utilisant le [SDK PlayFab Services](/fr/services/playfab/sdks/playfab-sdk-intro) pour configurer votre première monnaie virtuelle. Après avoir obtenu un jeton d'entité pour interagir avec votre titre via les API, vous créez et configurez une monnaie virtuelle.

## Prérequis

* Un [compte de développeur PlayFab](https://developer.playfab.com)
* Le SDK PlayFab bêta (vous trouverez plus d'informations dans le [démarrage rapide Postman](/fr/services/playfab/sdks/postman/postman-quickstart#adding-playfab-collections))

## Obtenir un jeton d'entité de titre

Pour modifier les données de configuration de votre titre via les API, vous devez d'abord obtenir un jeton d'entité de titre. Vous trouverez plus d'informations dans le [démarrage rapide Postman](/fr/services/playfab/sdks/postman/postman-quickstart#getting-a-title-entity-token)

## Créer une monnaie virtuelle

Pour créer une monnaie virtuelle, vous devez créer un brouillon d'objet (Draft Item) de type Currency.

### Game Manager

1. Accédez à l'onglet **Economy** dans Game Manager et sélectionnez **Catalog (V2)**.
2. Choisissez **Currency** et sélectionnez **New currency**.
3. Modifiez le **Title** et ajoutez une **Description**, par exemple `Diamonds`, `Our in-game currency of choice.`.
4. Sélectionnez **Save and publish** pour finaliser vos modifications.
5. Vérifiez que votre monnaie apparaît dans la liste **Currency**.

### API REST

Appelez [CreateDraftItem](https://learn.microsoft.com/en-us/rest/api/playfab/economy/catalog/create-draft-item). Utilisez le corps suivant :

```JSON theme={null}
{
  "Item": {
    "CreatorEntity": {
      "Id": "{{TitleID}}",
      "Type": "title"
    },
    "Type": "currency",
    "AlternateIds": [
      {
        "Type": "FriendlyId",
        "Value": "diamonds"
      }
    ],
    "Title": {
      "NEUTRAL": "Diamonds"
    },
    "Description": {
      "NEUTRAL": "Our in-game currency of choice."
    },
    "StartDate": "2023-07-27T00:00:00.000Z",
  },
  "Publish": true,
  "CustomTags": {
    "user": "{{Email}}"
  }
}
```

***

* `FriendlyId` est le code de la monnaie, qui peut contenir entre un et trois caractères alphanumériques
* `Title` est le nom d'affichage présenté aux joueurs
* `ContentType` est une catégorisation des objets Economy. Vous devez d'abord définir le type de contenu dans ⚙️ > Title Settings > Economy > Catalog (V2) Settings.
* `StartDate` est une chaîne de date et d'heure indiquant à partir de quand la monnaie est visible par les joueurs (par défaut, l'heure de création)

## Résolution des problèmes

* Jeton d'entité manquant/expiré
  * Si vous tentez d'appeler `CreateDraftItem` et recevez une erreur `401: Unauthorized`, vous avez peut-être oublié d'obtenir un jeton d'entité de titre, ou celui-ci a peut-être expiré
* Le type de contenu `''` n'est pas pris en charge
  * Si vous tentez d'appeler `CreateDraftItem` et recevez une erreur `CatalogBadRequest` avec le message ci-dessus, vous devez d'abord créer un type de contenu dans l'onglet des paramètres du catalogue, sur la page des paramètres de votre titre dans Game Manager

## Étapes suivantes

Maintenant que vous avez configuré votre première monnaie virtuelle, vous pouvez :

1. Ajouter la monnaie aux bundles PlayFab que vous vendez dans les magasins d'applications.
2. Faire en sorte que le serveur de jeu attribue la monnaie à vos joueurs avec [AddInventoryItems](https://learn.microsoft.com/en-us/rest/api/playfab/economy/inventory/add-inventory-items).
3. Attribuer aux objets du catalogue des prix correspondant à la monnaie.
4. Permettre aux joueurs d'acheter des objets du catalogue avec la monnaie à l'aide de [PurchaseInventoryItems](https://learn.microsoft.com/en-us/rest/api/playfab/economy/inventory/purchase-inventory-items).


## Related topics

- [Guide des BVT de certification pour console](/fr-CA/publishing/game-publishing/concepts/certification/certification-console-bvt-guide.md)
- [Guide BVT de certification pour console](/fr/publishing/game-publishing/concepts/certification/certification-console-bvt-guide.md)
- [Guide de certification étape par étape](/fr-CA/publishing/game-publishing/concepts/certification/certification-guide.md)
- [Notes de version du SDK C++ PlayFab Multiplayer](/fr/services/playfab/multiplayer/lobby/lobby-matchmaking-sdks/lobby-and-matchmaking-release-notes.md)
- [PFPlatformSpecificRegisterForIOSPushNotificationRequest](/fr/services/playfab/api-references/c/pfplatformspecifictypes/structs/pfplatformspecificregisterforiospushnotificationrequest.md)