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

# Información general sobre los sistemas de comercio del GDK

> Información general sobre los sistemas de comercio de Microsoft Store disponibles en el GDK: compras, derechos, consumibles, DLC, versiones de prueba, suscripciones y API de licencias.

Las características y servicios relacionados con el comercio disponibles en el GDK permiten varios modelos de monetización y la capacidad de una integración profunda de los servicios back-end con esas opciones de comercio. En este documento se proporciona una información general de estos sistemas y opciones, que se tratan con más detalle en la sección Comercio de la documentación del GDK.

## Características del lado cliente

El GDK permite a los juegos implementar varios tipos de complementos dentro del juego y tipos de productos, como consumibles, duraderos (contenido descargable), suscripciones, agrupaciones (bundles) y versiones de prueba. El conjunto de API de XStore proporciona la funcionalidad necesaria para consultar, anunciar y administrar estos productos desde el lado cliente. Para ver un ejemplo de una tienda dentro del juego completamente funcional, consulte el [ejemplo In-Game Store del GDK](https://github.com/microsoft/Xbox-GDK-Samples/tree/main/Samples/Live/InGameStore).

Los siguientes artículos de la sección Aspectos básicos tratan estas API y escenarios:

* [Operaciones básicas de la Store](/publishing/xstore-commerce/xstore-basic-operations): consulte qué está disponible para vender y qué posee el usuario
* [Cómo usar un producto duradero sin paquete](/publishing/xstore-commerce/xstore-dwob): uso de un producto duradero que no tiene un paquete de descarga independiente.
* [Administración y licencia de contenido descargable (DLC)](/publishing/xstore-commerce/xstore-dlc): uso de productos duraderos tradicionales con paquetes de descarga.
* [Ecosistemas basados en consumibles](/publishing/xstore-commerce/xstore-consumables): instalación y configuración de un modelo de monetización basado en consumibles dentro del juego.
* [Implementación de versiones de prueba para el juego](/publishing/xstore-commerce/xstore-trials): implementación de una versión de prueba integrada en el juego.
* [Agrupaciones y pases de temporada](/publishing/xstore-commerce/xstore-bundles-season-passes): uso de agrupaciones y pases de temporada para ofrecer valor e interacción a los clientes con sus productos.
* [Modelo de uso compartido de productos para juegos](/publishing/xstore-commerce/xstore-product-sharing): el modelo de licencias de los juegos del GDK tanto en la consola XBOX como en PC con Windows y cómo se aplica el uso compartido entre usuarios.

## Características del lado servidor

Los servicios de Microsoft Store que respaldan las API del lado cliente y permiten llamadas de servicio a servicio se dividen en los servicios siguientes:

* [Collections](/publishing/xstore-commerce/xstore-query-entitlements): proporciona información sobre qué productos posee el usuario o a cuáles tiene derecho, y completa productos consumibles. También se puede usar para detectar el estado de la suscripción a Game Pass para asociados autorizados.
* [Clawback](/publishing/xstore-commerce/xstore-managing-consumables): permite a los servicios de asociados detectar y administrar los reembolsos emitidos a los usuarios por consumibles ya completados.
* [Purchase](/reference/microsoft-store-apis/xstore-v8-grant): permite a los servicios de asociados agregar artículos gratuitos a la cuenta del usuario.
* Recurrence: proporciona información detallada sobre las suscripciones de un usuario y permite a los servicios de asociados administrar esas suscripciones en nombre del usuario.

### Autenticación con los servicios de Microsoft Store

Para obtener información detallada sobre cómo autenticar su servicio con los servicios de Microsoft Store, consulte [Solicitud de un User Store ID para la autenticación de servicio a servicio](/publishing/xstore-commerce/xstore-requesting-userstoreid).

<Note>
  Si está familiarizado con la autenticación con tokens X, el servicio Collections sí admite tokens X.
</Note>

Sin embargo, otros servicios de Microsoft Store no lo hacen. Debido a las valiosas características que ofrecen los demás servicios, ahora recomendamos que los asociados hagan la transición de sus flujos de autenticación de servidor a servidor al flujo de Microsoft Entra ID y UserStoreId.

Para ayudar a simplificar el flujo de autenticación y las llamadas a los servicios de Microsoft Store, revise el proyecto y el ejemplo Microsoft.StoreServices en GitHub. La biblioteca Microsoft.StoreServices ayuda a administrar las claves de autenticación y proporciona API contenedoras para llamar a los servicios de Microsoft Store para administrar productos. El proyecto de ejemplo destaca cómo un servicio puede usar la biblioteca Microsoft.StoreServices, lógica de ejemplo para administrar productos consumibles, conciliar compras reembolsadas, renovar credenciales expiradas y mucho más. Con el ejemplo se incluye una guía de configuración paso a paso para configurar el servicio de ejemplo en su PC o a través de Azure.

* [Biblioteca Microsoft.StoreServices (GitHub)](https://github.com/microsoft/Microsoft-Store-Services)
* [Ejemplo de Microsoft.StoreServices (GitHub)](https://github.com/microsoft/Microsoft-Store-Services-Sample)

## Información clave para los desarrolladores que usaron el XDK

Si está familiarizado con los sistemas de comercio del XDK, las definiciones siguientes deberían ayudarle a saber cómo se denominan los servicios equivalentes del GDK

* **Inventory Service**: la funcionalidad del servicio Inventory del XDK (consultar la propiedad, completar consumibles, etc.) ahora la gestiona el servicio Collections. Esto incluye todos los escenarios de servidor a servidor para validar la propiedad y las cantidades de consumibles. Aunque los tokens X usados para Inventory funcionan para llamar a Collections, se recomienda que los asociados pasen al flujo de autenticación con tokens de Microsoft Entra ID y User Store ID para usar la funcionalidad ampliada de los servicios de Microsoft Store.<br />Ejemplo: [https://collections.mp.microsoft.com/v8.0/collections/b2bLicensePreview](/reference/microsoft-store-apis/xstore-v8-query-for-products)
* **Inventory Client APIs**: toda la funcionalidad del lado cliente relacionada con la consulta de la propiedad de artículos ahora se gestiona a través de las API de XStore.<br />Ejemplo: [XStoreQueryEntitledProductsAsync](/reference/system/xstore/xstore_members) devuelve los artículos que el usuario actual tiene derecho a usar en ese momento.
* **Catalog Browse APIs**: toda la funcionalidad del lado cliente relacionada con la consulta de los productos disponibles para comprar dentro del juego ahora se gestiona a través de las API de XStore. No hay ninguna opción de servidor a servidor para consultar los productos disponibles para vender dentro del título.<br />Ejemplo: [XStoreQueryAssociatedProductsAsync](/reference/system/xstore/xstore_members) devuelve los productos que se pueden vender como parte de una tienda dentro del juego.
* **Trials and Licenses**: toda la funcionalidad del lado cliente relacionada con las licencias de prueba ahora forma parte de las API de XStore. Ejemplo: [XStoreQueryGameLicenseAsync](/reference/system/xstore/xstore_members) devuelve la información de licencia del juego actual, incluida cualquier información de licencia de prueba. Para poder validar una licencia del lado cliente en su propio servicio, consulte [Uso de tokens de licencia para validar las licencias en sus servicios](/publishing/xstore-commerce/xstore-license-tokens).

## Documentación de referencia de la API

* [XStore (contenido de la API)](/reference/system/xstore/xstore_members)
  * Funciones
    * [XStoreQueryEntitledProductsAsync](/reference/system/xstore/xstore_members)
    * [XStoreQueryAssociatedProductsAsync](/reference/system/xstore/xstore_members)
    * [XStoreQueryGameLicenseAsync](/reference/system/xstore/xstore_members)

## Consulte también

[Configuración inicial en Partner Center](/publishing/xstore-commerce/xstore-initial-configuration)

[Operaciones básicas de la Store](/publishing/xstore-commerce/xstore-basic-operations)

[Administración de productos desde su servicio](/publishing/xstore-commerce/xstore-authenticating-service)

[Consideraciones específicas de PC](/publishing/xstore-commerce/xstore-pc)

[Referencia de la API de XStore](/reference/system/xstore/xstore_members)


## Related topics

- [Información general sobre el comercio de XStore](/es/publishing/xstore-commerce/xstore-commerce-overview.md)
- [Información general del sistema de contactos (lista de amigos)](/es/services/xbox-services/community/people-system/live-people-system-overview.md)
- [Información general sobre los conceptos de multijugador](/es/services/xbox-services/multiplayer/concepts/live-multiplayer-concepts.md)
- [Información general sobre los datos de jugador de XBOX](/es/services/xbox-services/player-data/live-playerdata-overview.md)
- [Información general sobre los sandboxes de los servicios XBOX](/es/services/xbox-services/fundamentals/sandboxes/live-setup-sandbox.md)