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

# XStore 커머스 개요

> XStore API, Partner Center, Microsoft Store REST 서비스가 XBOX 및 PC 커머스, 기본 게임, DLC 등을 위해 어떻게 함께 작동하는지 알아봅니다.

**XStore** API는 GDK 기반의 XBOX 및 PC 타이틀을 위한 Microsoft Store 커머스의 런타임 측면입니다. Partner Center(제품을 모델링하는 곳) 및 Microsoft Store 서비스 간(S2S) REST API(백엔드에서 사용 권한을 쿼리하고 부여하는 곳)와 함께, 기본 게임, DLC, 트라이얼, 소모품, 구독, 번들을 위한 완전한 커머스 플랫폼을 제공합니다.

이 섹션은 Microsoft Learn의 주제 레이아웃을 반영하며 타이틀에 대한 스토어 커머스를 설계, 통합, 테스트, 운영하는 데 필요한 모든 것을 다룹니다.

<Info>
  **Microsoft Store 서비스 간 REST 참조**(collections, purchase, clawback, grant, recurrences)를 찾고 계신가요? **API** 탭 아래의 [Microsoft Store REST APIs](/reference/microsoft-store-apis/index)에 있습니다.
</Info>

## 이 섹션의 내용

<CardGroup cols={2}>
  <Card title="시작하기" icon="rocket" href="/publishing/xstore-commerce/xstore-initial-configuration">
    개요, 제품 유형, Partner Center 설정, 테스트, 라이선싱, 문제 해결.
  </Card>

  <Card title="기본 사항" icon="cube" href="/publishing/xstore-commerce/xstore-basic-operations">
    기본 스토어 작업, DLC, 트라이얼, 소모품, 번들, DWOB, 업데이트.
  </Card>

  <Card title="서비스에서 관리" icon="network-wired" href="/publishing/xstore-commerce/xstore-authenticating-service">
    서비스 인증, 사용 권한 쿼리, 구독, 환불, User Store ID.
  </Card>

  <Card title="PC 관련 고려 사항" icon="windows" href="/publishing/xstore-commerce/xstore-pc">
    DRM, 라이선스 토큰, 스토어 계정 불일치 처리, 샌드박스 전환.
  </Card>

  <Card title="Microsoft Store REST API" icon="code" href="/reference/microsoft-store-apis/index">
    v8/v9 collections, purchase, clawback, grant, recurrences 엔드포인트에 대한 참조입니다. 전체 참조는 이제 **API** 탭 아래의 [Microsoft Store REST APIs](/reference/microsoft-store-apis/index)에 있습니다.
  </Card>

  <Card title="프랜차이즈 게임 허브" icon="sitemap" href="/publishing/game-publishing/concepts/game-publisher-insights/game-publisher-insights-faq">
    여러 제품을 단일 스토어 프랜차이즈 허브 아래에 그룹화합니다.
  </Card>
</CardGroup>

## 큰 그림: 각 요소가 어떻게 연결되는가

* **Partner Center** — 제품(기본 게임, 추가 기능, 번들, 시즌 패스, 구독, 소모품)을 만들고, 가격과 사용 가능 여부를 정의하고, 식별자(**StoreId**, **Product ID**, **BigId**, **SKU ID**)를 할당하는 곳입니다.
* **`MicrosoftGame.config`** — 타이틀 패키지 내부에 포함되며 `TitleId`, `StoreId`, `MSAAppId`를 통해 실행 중인 실행 파일을 스토어 제품에 바인딩합니다.
* **XStore 런타임 API (`XStore*`)** — 제품을 열거하고, 라이선스 및 사용 권한을 쿼리하고, 구매 UI를 표시하고, 소모품 이행을 보고하기 위해 게임에서 이루어지는 클라이언트 측 호출입니다.
* **XPackage API (`XPackage*`)** — 선택적 패키지(DLC)를 마운트하고 라이선스를 부여하고, 청크를 설치하고, 패키지 상태 변경을 관찰합니다.
* **Microsoft Store S2S REST API** — 백엔드가 호출하여 권한 있는 방식으로 사용 권한을 쿼리하고, 소모품을 이행하고, 제품을 부여하고, 구독을 조회하고, 환불/clawback을 처리하는 서버 측 엔드포인트입니다.
* **User Store ID (UserStoreId)** — 타이틀이 `XUserGetTokenAndSignatureAsync`(또는 `XStoreGetUserCollectionsIdAsync` / `XStoreGetUserPurchaseIdAsync`)를 통해 얻는 짧은 수명의 키로, 서비스가 해당 사용자를 대신하여 스토어를 호출할 수 있도록 서비스에 전달됩니다.

## 클라이언트와 서비스

거의 모든 스토어 시나리오에는 **클라이언트 측**(XStore)과 **서비스 측**(S2S REST) 경로가 모두 있습니다. 실시간 UX(구매 버튼 표시, 콘텐츠 잠금 해제, 소모품 지출 보고)에는 클라이언트를 사용하고, 권한이 중요한 경우(타이틀 재설치를 견뎌야 하는 가상 통화 지출 이행, 프로모션 항목 부여, Game Pass 감지, 환불 처리)에는 서비스를 사용하세요.

신뢰할 수 있는 패턴은 다음과 같습니다.

1. 클라이언트가 구매 또는 지출을 감지하고 즉각적인 UX를 표시합니다.
2. 클라이언트가 UserStoreId를 서비스에 전송합니다.
3. 서비스가 Store S2S API를 호출하여 사용 권한을 확인하거나 소모품을 이행하고, 기록의 원본 데이터베이스를 업데이트합니다.

## 다음 단계

XStore를 처음 사용하는 경우 [GDK 커머스 시스템 개요](/publishing/xstore-commerce/xstore-overview)부터 시작한 다음 [올바른 제품 유형 선택](/publishing/xstore-commerce/xstore-choosing-product-type)으로 이동하세요.


## Related topics

- [GDK 커머스 시스템 개요](/ko/publishing/xstore-commerce/xstore-overview.md)
- [XStore](/ko/reference/system/xstore/xstore_members.md)
- [XStore 개발 문제 해결](/ko/publishing/xstore-commerce/xstore-troubleshooting.md)
- [기본 DRM 및 라이선스 검사](/ko/publishing/xstore-commerce/xstore-basic-drm.md)
- [XStore 개발 및 테스트 활성화](/ko/publishing/xstore-commerce/xstore-product-testing-setup.md)