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

# Inicio rápido de moneda virtual de Economy v2

> Cree y configure su primera moneda virtual de PlayFab Economy v2 con Game Manager o las API de Catalog usando un token de entidad de título.

# Configuración de su primera moneda virtual

<Info>
  Economy v2 ya está disponible con carácter general. Para soporte y comentarios, vaya al [Foro de PlayFab](https://community.playfab.com).
</Info>

Empiece a trabajar con PlayFab Economy mediante el [SDK de PlayFab Services](/services/playfab/sdks/playfab-sdk-intro) para configurar su primera moneda virtual. Después de obtener un token de entidad para interactuar con su título a través de las API, creará y configurará una moneda virtual.

## Requisitos previos

* Una [cuenta de desarrollador de PlayFab](https://developer.playfab.com)
* El SDK beta de PlayFab (puede encontrar más información en el [Inicio rápido de Postman](/services/playfab/sdks/postman/postman-quickstart#adding-playfab-collections))

## Obtención de un token de entidad de título

Para realizar cambios en los datos de configuración de su título a través de las API, primero necesita obtener un token de entidad de título. Puede encontrar más información en el [Inicio rápido de Postman](/services/playfab/sdks/postman/postman-quickstart#getting-a-title-entity-token)

## Creación de una nueva moneda virtual

Para crear una nueva moneda virtual, debe crear un elemento de borrador (Draft Item) de tipo Currency.

### Game Manager

1. Vaya a la pestaña **Economy** en Game Manager y seleccione **Catalog (V2)**.
2. Elija **Currency** y seleccione **New currency**.
3. Edite el **Title** y agregue una **Description**; por ejemplo, `Diamonds`, `Our in-game currency of choice.`.
4. Seleccione **Save and publish** para completar los cambios.
5. Observe su moneda en la lista **Currency**.

### API REST

Llame a [CreateDraftItem](https://learn.microsoft.com/en-us/rest/api/playfab/economy/catalog/create-draft-item). Use el siguiente cuerpo:

```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}}"
  }
}
```

***

* El `FriendlyId` es el código de moneda, que puede contener entre uno y tres valores alfanuméricos
* El `Title` es el nombre para mostrar que se muestra a los jugadores
* `ContentType` es una categorización de los elementos de Economy. Primero debe establecer el tipo de contenido en ⚙️ > Title Settings > Economy > Catalog (V2) Settings.
* `StartDate` es una cadena de fecha y hora que representa cuándo la moneda es visible para los jugadores (el valor predeterminado es el momento de la creación)

## Solución de problemas

* Token de entidad ausente o expirado
  * Si intenta llamar a `CreateDraftItem` y recibe un error `401: Unauthorized`, es posible que haya olvidado obtener un token de entidad de título o que haya expirado
* El tipo de contenido `''` no es compatible
  * Si intenta llamar a `CreateDraftItem` y recibe un `CatalogBadRequest` con el mensaje anterior, primero debe crear un tipo de contenido en la pestaña de configuración del catálogo, en la página de configuración de su título en Game Manager

## Pasos siguientes

Ahora que ha configurado su primera moneda virtual, puede:

1. Agregar la moneda a las agrupaciones (Bundles) de PlayFab que venda en las tiendas de aplicaciones.
2. Hacer que el servidor del juego recompense a sus jugadores con la moneda mediante [AddInventoryItems](https://learn.microsoft.com/en-us/rest/api/playfab/economy/inventory/add-inventory-items).
3. Asignar precios a los elementos del catálogo correspondientes a la moneda.
4. Permitir que los jugadores compren elementos del catálogo con la moneda mediante [PurchaseInventoryItems](https://learn.microsoft.com/en-us/rest/api/playfab/economy/inventory/purchase-inventory-items).


## Related topics

- [Inicio rápido de Economy (heredada)](/es/services/playfab/economy-monetization/economy/quickstart.md)
- [Inicio rápido](/es/services/playfab/economy-monetization/economy-v2/quickstart.md)
- [Inicio rápido de artículos (Economía heredada)](/es/services/playfab/economy-monetization/economy/items/quickstart.md)
- [Guía de inicio rápido de prevención de fraude](/es/services/playfab/economy-monetization/economy-v2/fraud-prevention/quickstart.md)
- [Guía de inicio rápido del inventario del jugador](/es/services/playfab/economy-monetization/economy-v2/inventory/quickstart.md)