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

# Visão geral dos sistemas de comércio do GDK

> Visão geral dos sistemas de comércio da Microsoft Store disponíveis no GDK: compras, direitos, consumíveis, DLC, avaliações, assinaturas e APIs de licenciamento.

Os recursos e serviços relacionados a comércio disponíveis no GDK permitem vários modelos de monetização e a possibilidade de integração profunda de serviços de back-end com essas opções de comércio. Este documento fornece uma visão geral desses sistemas e opções, que são abordados com mais profundidade na seção Comércio da documentação do GDK.

## Recursos do lado do cliente

O GDK permite que os jogos implementem vários tipos de complementos e tipos de produto no jogo, como consumíveis, duráveis (conteúdo para download), assinaturas, pacotes e avaliações. O conjunto de APIs XStore fornece a funcionalidade necessária para consultar, anunciar e gerenciar esses produtos do lado do cliente. Para ver um exemplo de uma loja no jogo totalmente funcional, consulte o [exemplo GDK In-Game Store](https://github.com/microsoft/Xbox-GDK-Samples/tree/main/Samples/Live/InGameStore).

Os artigos a seguir, na seção Fundamentos, abordam essas APIs e cenários:

* [Operações básicas da loja](/pt-BR/publishing/xstore-commerce/xstore-basic-operations) - Consultar o que está disponível para venda e o que o usuário possui
* [Como usar um durável sem pacote](/pt-BR/publishing/xstore-commerce/xstore-dwob) - Usar um durável que não tem um pacote de download separado.
* [Gerenciar e licenciar conteúdo para download (DLC)](/pt-BR/publishing/xstore-commerce/xstore-dlc) - Usar duráveis tradicionais com pacotes de download.
* [Ecossistemas baseados em consumíveis](/pt-BR/publishing/xstore-commerce/xstore-consumables) - Configurar um modelo de monetização baseado em consumíveis no seu jogo.
* [Implementar avaliações para seu jogo](/pt-BR/publishing/xstore-commerce/xstore-trials) - Implementar uma avaliação integrada ao seu jogo.
* [Pacotes e Season Passes](/pt-BR/publishing/xstore-commerce/xstore-bundles-season-passes) - Usar pacotes e Season Passes para oferecer valor e engajamento aos clientes com seus produtos.
* [Modelo de compartilhamento de produtos para jogos](/pt-BR/publishing/xstore-commerce/xstore-product-sharing) - O modelo de licenciamento para jogos do GDK no console XBOX e no PC com Windows e como o compartilhamento entre usuários é aplicado.

## Recursos do lado do servidor

Os Microsoft Store Services que dão suporte às APIs do lado do cliente e permitem chamadas de serviço para serviço são divididos nos seguintes serviços:

* [Collections](/pt-BR/publishing/xstore-commerce/xstore-query-entitlements) - Fornece informações sobre quais produtos o usuário possui ou tem direito de usar e atende produtos consumíveis. Também pode ser usado para detectar o status da assinatura do Game Pass para parceiros autorizados.
* [Clawback](/pt-BR/publishing/xstore-commerce/xstore-managing-consumables) - Permite que os serviços de parceiros detectem e gerenciem reembolsos emitidos aos usuários por consumíveis já atendidos.
* [Purchase](/pt-BR/reference/microsoft-store-apis/xstore-v8-grant) - Permite que os serviços de parceiros adicionem itens gratuitos à conta do usuário.
* Recurrence - Fornece informações detalhadas sobre as assinaturas de um usuário e permite que os serviços de parceiros gerenciem essas assinaturas em nome do usuário.

### Autenticar com os Microsoft Store Services

Para obter informações detalhadas sobre como autenticar seu serviço com os Microsoft Store Services, consulte [Solicitar um ID de usuário da Store para autenticação de serviço para serviço](/pt-BR/publishing/xstore-commerce/xstore-requesting-userstoreid).

<Note>
  Se você estiver familiarizado com a autenticação por X-token, o serviço Collections dá suporte a X-tokens.
</Note>

No entanto, os outros Microsoft Store Services não dão. Devido aos recursos valiosos oferecidos nos outros serviços, agora recomendamos que os parceiros façam a transição de seus fluxos de autenticação de servidor para servidor para o fluxo do Microsoft Entra ID e UserStoreId.

Para ajudar a simplificar o fluxo de autenticação e as chamadas aos Microsoft Store Services, examine o projeto e o exemplo Microsoft.StoreServices no GitHub. A biblioteca Microsoft.StoreServices ajuda a gerenciar as chaves de autenticação e fornece APIs wrapper para chamar os Microsoft Store Services para gerenciar produtos. O projeto de exemplo destaca como um serviço pode usar a biblioteca Microsoft.StoreServices, lógica de exemplo para gerenciar produtos consumíveis, reconciliar compras reembolsadas, renovar credenciais expiradas e muito mais. Um guia de configuração passo a passo está incluído no exemplo para configurar o serviço de exemplo no seu PC ou por meio do Azure.

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

## Informações importantes para desenvolvedores que usaram o XDK

Se você estiver familiarizado com os sistemas de comércio do XDK, as definições a seguir devem ajudar a orientar você sobre como os serviços equivalentes do GDK são chamados

* **Inventory Service** - A funcionalidade do serviço Inventory do XDK (consultar propriedade, atender consumíveis etc.) agora é tratada pelo serviço Collections. Isso inclui todos os cenários de servidor para servidor para validar a propriedade e as quantidades de consumíveis. Embora os X-tokens usados para Inventory funcionem para chamar Collections, recomendamos que os parceiros migrem para o fluxo de autenticação por token do Microsoft Entra ID e ID de usuário da Store para usar a funcionalidade expandida dos Microsoft Store Services.<br />Exemplo: [https://collections.mp.microsoft.com/v8.0/collections/b2bLicensePreview](/pt-BR/reference/microsoft-store-apis/xstore-v8-query-for-products)
* **APIs de cliente do Inventory** - Toda a funcionalidade do lado do cliente relacionada à consulta de propriedade de itens agora é tratada por meio das APIs XStore.<br />Exemplo: [XStoreQueryEntitledProductsAsync](/pt-BR/reference/system/xstore/xstore_members) retorna os itens que o usuário atual tem direito de usar naquele momento.
* **APIs Catalog Browse** - Toda a funcionalidade do lado do cliente relacionada à consulta de produtos disponíveis para compra no jogo agora é tratada por meio das APIs XStore. Não há opção de servidor para servidor para consultar produtos disponíveis para venda no seu título.<br />Exemplo: [XStoreQueryAssociatedProductsAsync](/pt-BR/reference/system/xstore/xstore_members) retorna produtos que podem ser vendidos como parte de uma loja no jogo.
* **Avaliações e licenças** - Toda a funcionalidade do lado do cliente relacionada a licenças de avaliação agora faz parte das APIs XStore. Exemplo: [XStoreQueryGameLicenseAsync](/pt-BR/reference/system/xstore/xstore_members) retorna as informações de licença do jogo atual, incluindo qualquer informação de licença de avaliação. Para poder validar uma licença do lado do cliente no seu próprio serviço, consulte [Usar tokens de licença para validar o licenciamento nos seus serviços](/pt-BR/publishing/xstore-commerce/xstore-license-tokens).

## Documentação de referência da API

* [XStore (conteúdo da API)](/pt-BR/reference/system/xstore/xstore_members)
  * Funções
    * [XStoreQueryEntitledProductsAsync](/pt-BR/reference/system/xstore/xstore_members)
    * [XStoreQueryAssociatedProductsAsync](/pt-BR/reference/system/xstore/xstore_members)
    * [XStoreQueryGameLicenseAsync](/pt-BR/reference/system/xstore/xstore_members)

## Confira também

[Configuração inicial no Partner Center](/pt-BR/publishing/xstore-commerce/xstore-initial-configuration)

[Operações básicas da Store](/pt-BR/publishing/xstore-commerce/xstore-basic-operations)

[Gerenciar produtos a partir do seu serviço](/pt-BR/publishing/xstore-commerce/xstore-authenticating-service)

[Considerações específicas para PC](/pt-BR/publishing/xstore-commerce/xstore-pc)

[Referência da API XStore](/pt-BR/reference/system/xstore/xstore_members)


## Related topics

- [Visão geral do XBOX Series X|S](/pt-BR/paths/series-xs/overview.md)
- [Visão geral do Unity](/pt-BR/paths/unity/overview.md)
- [Visão geral de acessibilidade no GDK](/pt-BR/build/game-principles/accessibility/accessibility-overview.md)
- [Visão geral do Unreal Engine](/pt-BR/paths/unreal/overview.md)
- [Visão geral de portabilidade](/pt-BR/paths/porting/overview.md)