> ## 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 artículos (Economía heredada)

> Inicio rápido para crear artículos de catálogo en PlayFab Legacy Economy (v1), incluidas las propiedades de los artículos, las monedas virtuales y la concesión de artículos a los jugadores.

# Inicio rápido de artículos (Economía heredada)

<Info>
  Las API de Economy v1 están en modo de mantenimiento y no recibirán nuevas características, solo correcciones de errores. **Las API v1 se mantendrán en el futuro previsible.** Consulte la [Información general de Economy v2](/services/playfab/economy-monetization/economy-v2/overview) para obtener más información sobre la próxima versión de PlayFab Economy.
</Info>

El inicio rápido de artículos le proporciona los bloques de creación de la economía de su juego: moneda virtual, catálogos, artículos y compras.

En este inicio rápido, hará lo siguiente:

* Configurar una moneda virtual para su juego.
* Dar moneda virtual a un jugador.
* Agregar un artículo al catálogo del juego.
* Usar las API de PlayFab para comprar un artículo del catálogo con moneda virtual.
* Usar información de Game Manager para confirmar que la compra fue exitosa.

## Configuración de una moneda virtual

PlayFab admite una economía de juego sólida con varias monedas y artículos.

Para acceder a estas características y crear una moneda virtual:

1. Abra **Game Manager** y seleccione **Economy** en la barra lateral izquierda.
2. Seleccione la pestaña **Currency** y, después, seleccione **New Currency** (se abre la pantalla **New Currency** que se muestra a continuación).
3. Para crear su moneda virtual, edite estos campos:
   * Establezca **Currency code (2 uppercase characters)** en **GD**.
   * Establezca **Display name** en **Gold**.
4. Seleccione **SAVE CURRENCY**.

<img src="https://mintcdn.com/microsoft-4404708b/Oa_DP1q6U1lat7c2/images/playfab/economy-monetization/economy/tutorials/game-manager-economy-currency-new-currency.png?fit=max&auto=format&n=Oa_DP1q6U1lat7c2&q=85&s=fcf039d9e16ac42519f73544b6f3a8fd" alt="Guardar nueva moneda" width="1200" height="394" data-path="images/playfab/economy-monetization/economy/tutorials/game-manager-economy-currency-new-currency.png" />

## Dar moneda virtual a un jugador

Puede dar moneda virtual directamente a los jugadores. Como ejemplo, agreguemos dinero a un jugador mediante Game Manager:

1. Seleccione **Players** en la barra lateral izquierda y, después, seleccione el **ID** de un jugador.
2. Vaya a la pestaña **Virtual Currency** del jugador.
3. Elija la moneda **GD** (se abre la pantalla **Modify Virtual Currency** que se muestra a continuación).
4. Cambie el **Amount** a **100**.
5. Seleccione **SAVE VIRTUAL CURRENCY**.

<img src="https://mintcdn.com/microsoft-4404708b/Oa_DP1q6U1lat7c2/images/playfab/economy-monetization/economy/tutorials/game-manager-players-modify-virtual-currency.png?fit=max&auto=format&n=Oa_DP1q6U1lat7c2&q=85&s=5d2fe1627373acec744bdc1b9eee490a" alt="Modificar moneda" width="1200" height="698" data-path="images/playfab/economy-monetization/economy/tutorials/game-manager-players-modify-virtual-currency.png" />

<Tip>
  Puede ser peligroso dar a los clientes la capacidad de llamar a la API [AddUserVirtualCurrency](xref:titleid.playfabapi.com.client.playeritemmanagement.adduservirtualcurrency). Para obtener información sobre cómo establecer restricciones en API específicas, consulte [Directiva de acceso a la API](/services/playfab/api-references/api-access-policy).
</Tip>

Ahora el jugador tiene 100 de oro. ¿Qué puede hacer con él? ¡Comprar un artículo!

## Agregar un artículo al catálogo del juego

*¡No tiene sentido tener dinero si no puede gastarlo!*

Puede crear catálogos (una colección de artículos) que correspondan a las plataformas en las que va a publicar su juego, o a los números de versión principales; lo que prefiera.

<Tip>
  No recomendamos crear varios catálogos para diferenciar tipos de artículos. Puede filtrar los artículos de forma más eficaz mediante clases, etiquetas y tiendas.
</Tip>

Para crear un catálogo con un artículo:

1. Seleccione **Economy** en la barra lateral izquierda y seleccione la pestaña **Catalogs**.
2. Seleccione el botón **New Catalog** y escriba **main** como **Catalog version**. Se agrega automáticamente un artículo con el identificador **One**.
3. Seleccione **One** (se abre la pantalla **Edit Catalog Item** que se muestra a continuación). Edite estos campos:
   * Establezca **Item ID** en **apple**.
   * Establezca **Display name** en **apple**.
   * Establezca **Description** en **Perfectly normal apple**.

En la parte inferior del formulario está la sección **PRICES**, donde define cuánto cuesta un artículo en la moneda virtual de su juego.

1. Establezca el precio de la manzana en oro (**GD**) en **5**.
2. Seleccione **SAVE ITEM**.

<img src="https://mintcdn.com/microsoft-4404708b/Oa_DP1q6U1lat7c2/images/playfab/economy-monetization/economy/tutorials/game-manager-economy-catalogs-edit-catalog-item.png?fit=max&auto=format&n=Oa_DP1q6U1lat7c2&q=85&s=ae4198cca873fbbc16663f5f7b827423" alt="Agregar al catálogo" width="1280" height="1200" data-path="images/playfab/economy-monetization/economy/tutorials/game-manager-economy-catalogs-edit-catalog-item.png" />

## Compra de un artículo con moneda virtual

Usemos las API de PlayFab para realizar una compra en su juego.

1. Inicie sesión como el jugador al que se le asignaron 100 de oro en moneda virtual (como se describe en [Dar moneda virtual a un jugador](#dar-moneda-virtual-a-un-jugador)).
2. Llame a [GetCatalogItems](xref:titleid.playfabapi.com.client.title-widedatamanagement.getcatalogitems) con el siguiente parámetro en la solicitud:
   * `CatalogVersion = "main"`
3. Compruebe que el `Catalog` del resultado contiene una **apple** con un precio **GD** de **5**.
4. Compre la manzana llamando a [PurchaseItem](xref:titleid.playfabapi.com.client.playeritemmanagement.purchaseitem) con estos valores de parámetro en la solicitud:
   * `CatalogVersion = "main"`
   * `ItemId = "apple"`
   * `VirtualCurrency = "GD"`
   * `Price = 5`
5. Finalmente, llame a [GetUserInventory](xref:titleid.playfabapi.com.client.playeritemmanagement.getuserinventory) y examine el resultado de ese método. En la matriz de artículos del inventario del jugador, ¡debería ver una manzana!

## Confirmación de que la compra fue exitosa

Para confirmar la compra en Game Manager:

1. Seleccione **Players** en la barra lateral izquierda para abrir la pestaña **Players**.
2. Seleccione el **ID** del jugador que compró el artículo.

Para confirmar:

* Abra la pestaña **PlayStream**. Debería ver un evento [Player virtual currency item purchased](/services/playfab/api-references/events/Player/player-vc-item-purchased).
* Abra la pestaña **Inventory**. El inventario ahora debería contener una manzana. También puede usar las características de la pestaña **Inventory** para revocar el artículo o conceder al jugador *más* manzanas.
* Abra la pestaña **Virtual Currency**. El jugador solo debería tener 95 de oro restantes.


## Related topics

- [Inicio rápido de tiendas (Economía heredada)](/es/services/playfab/economy-monetization/economy/stores/quickstart.md)
- [Inicio rápido de Economy (heredada)](/es/services/playfab/economy-monetization/economy/quickstart.md)
- [Artículos (Economía heredada)](/es/services/playfab/economy-monetization/economy/items/index.md)
- [Guía de inicio rápido del inventario del jugador](/es/services/playfab/economy-monetization/economy-v2/inventory/quickstart.md)
- [Catálogos (Economía heredada)](/es/services/playfab/economy-monetization/economy/items/catalogs.md)