> ## 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 do comércio XStore

> Saiba como as APIs XStore, o Partner Center e os serviços REST da Microsoft Store se integram para o comércio no XBOX e no PC, jogos base, DLC e muito mais.

As APIs **XStore** são o lado de tempo de execução do comércio da Microsoft Store para títulos de XBOX e PC criados com o GDK. Juntamente com o Partner Center (onde você modela seus produtos) e as APIs REST de serviço para serviço (S2S) da Microsoft Store (onde seu back-end consulta e concede direitos), elas oferecem uma plataforma de comércio completa para jogos base, DLC, avaliações, consumíveis, assinaturas e pacotes.

Esta seção espelha a estrutura de tópicos do Microsoft Learn e abrange tudo de que você precisa para projetar, integrar, testar e operar o comércio da Store para o seu título.

<Info>
  Procurando a **referência REST de serviço para serviço da Microsoft Store** (coleções, compra, clawback, concessão, recorrências)? Ela está na guia **API**, em [APIs REST da Microsoft Store](/pt-BR/reference/microsoft-store-apis/index).
</Info>

## Nesta seção

<CardGroup cols={2}>
  <Card title="Introdução" icon="rocket" href="/pt-BR/publishing/xstore-commerce/xstore-initial-configuration">
    Visão geral, tipos de produto, configuração do Partner Center, testes, licenciamento e solução de problemas.
  </Card>

  <Card title="Fundamentos" icon="cube" href="/pt-BR/publishing/xstore-commerce/xstore-basic-operations">
    Operações básicas da loja, DLC, avaliações, consumíveis, pacotes, DWOB e atualizações.
  </Card>

  <Card title="Gerenciar a partir dos seus serviços" icon="network-wired" href="/pt-BR/publishing/xstore-commerce/xstore-authenticating-service">
    Autenticar serviços, consultar direitos, assinaturas, reembolsos e User Store IDs.
  </Card>

  <Card title="Considerações específicas do PC" icon="windows" href="/pt-BR/publishing/xstore-commerce/xstore-pc">
    DRM, tokens de licença, tratamento de contas da loja incompatíveis e troca de sandbox.
  </Card>

  <Card title="APIs REST da Microsoft Store" icon="code" href="/pt-BR/reference/microsoft-store-apis/index">
    Referência para os pontos de extremidade v8/v9 de coleções, compra, clawback, concessão e recorrências. A referência completa agora está na guia **API**, em [APIs REST da Microsoft Store](/pt-BR/reference/microsoft-store-apis/index).
  </Card>

  <Card title="Hubs de franquias de jogos" icon="sitemap" href="/pt-BR/publishing/game-publishing/concepts/game-publisher-insights/game-publisher-insights-faq">
    Agrupe vários produtos em um único hub de franquia da Store.
  </Card>
</CardGroup>

## Visão geral: como as peças se conectam

* **Partner Center** — onde você cria produtos (jogos base, complementos, pacotes, passes de temporada, assinaturas, consumíveis), define preços e disponibilidade e atribui identificadores (**StoreId**, **Product ID**, **BigId**, **SKU ID**).
* **`MicrosoftGame.config`** — é fornecido dentro do pacote do título e vincula o executável em execução ao produto da Store por meio de `TitleId`, `StoreId` e `MSAAppId`.
* **APIs de tempo de execução XStore (`XStore*`)** — chamadas do lado do cliente feitas pelo jogo para enumerar produtos, consultar licenças e direitos, mostrar a interface de compra e relatar o atendimento de consumíveis.
* **APIs XPackage (`XPackage*`)** — montam e licenciam pacotes opcionais (DLC), instalam partes e observam alterações de estado dos pacotes.
* **APIs REST S2S da Microsoft Store** — pontos de extremidade do lado do servidor que seu back-end chama para consultar direitos de forma autoritativa, atender consumíveis, conceder produtos, pesquisar assinaturas e processar reembolsos/clawbacks.
* **User Store ID (UserStoreId)** — uma chave de curta duração que o título obtém por meio de `XUserGetTokenAndSignatureAsync` (ou `XStoreGetUserCollectionsIdAsync` / `XStoreGetUserPurchaseIdAsync`) e entrega ao seu serviço para que ele possa chamar a Store em nome desse usuário.

## Cliente versus serviço

Quase todos os cenários da Store têm um caminho **do lado do cliente** (XStore) e um **do lado do serviço** (REST S2S). Use o cliente para a experiência do usuário em tempo real (mostrar o botão de compra, desbloquear conteúdo, relatar um gasto de consumível); use o serviço quando a autoridade importar (atender um gasto de moeda virtual que precisa sobreviver a reinstalações do título, conceder um item promocional, detectar o Game Pass, processar um reembolso).

Um padrão confiável:

1. O cliente detecta a compra ou o gasto e mostra a experiência imediata.
2. O cliente envia um UserStoreId ao seu serviço.
3. O serviço chama a API S2S da Store para confirmar o direito ou atender o consumível e atualiza seu banco de dados de registro.

## Próximas etapas

Se você é novo no XStore, comece com [Visão geral dos sistemas de comércio do GDK](/pt-BR/publishing/xstore-commerce/xstore-overview) e depois [Escolhendo o tipo de produto certo](/pt-BR/publishing/xstore-commerce/xstore-choosing-product-type).


## Related topics

- [Visão geral do Unity](/pt-BR/paths/unity/overview.md)
- [Visão geral de portabilidade](/pt-BR/paths/porting/overview.md)
- [Visão geral do Unreal Engine](/pt-BR/paths/unreal/overview.md)
- [Visão geral do XBOX Series X|S](/pt-BR/paths/series-xs/overview.md)
- [Visão geral do Windows & ROG XBOX Ally](/pt-BR/paths/windows/overview.md)