{"templateId":"openapi_docs","sharedDataIds":{"openAPIDocsStore":"oas-@l10n/ko/api/catalog/index.yaml","sidebar":"sidebar-@l10n/ko/catalog-en.sidebars.yaml"},"props":{"definitionId":"@l10n/ko/api/catalog/index.yaml","dynamicMarkdocComponents":[],"baseSlug":"/ko/api/catalog","seo":{"title":"개요","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]},"description":"게임 키는 게임 플랫폼에서 사용자가 게임이나 DLC에 접근할 수 있도록 해주는 일회용 고유 영숫자 코드입니다. [직접 링크](/ko/sell-games/set-up-selling-game-keys/#guides_game_sales_selling_game_keys_selling_via_direct_link), [스토어 UI](/ko/sell-games/set-up-selling-game-keys/#guides_game_sales_selling_game_keys_selling_via_store_ui), 또는 [위젯](/ko/sell-games/set-up-selling-game-keys/#guides_game_sales_selling_items_develop_buttons)을 통해 게임 키를 판매할 수 있습니다. 또한 [지역 제한 설정](/ko/items-catalog/catalog-features/regional-restrictions/)을 통해 특정 국가에서만 게임 키를 판매하도록 설정할 수 있습니다. 자세한 내용은 [게임 키 패키지](https://developers.xsolla.com/ko/items-catalog/items-type/set-up-modules/) 섹션을 참조해 주세요.\n\n게임 키를 판매하는 데 사용자 인증은 필요하지 않습니다. 키는 사용자가 결제 시 지정한 이메일 주소로 발송됩니다. 추가 시나리오를 활성화하기 위해 인증을 구성할 수 있습니다. [사용자 맞춤 설정](/ko/liveops/liveops-management/personalization-tutorial/), [구매 제한](/ko/items-catalog/catalog-features/items-catalog-number-limits/), 또는 [자격 시스템](/ko/sell-games/how-to/entitlement-system/). 자세한 내용은 [게임 키 판매 시 인증 설정 방법](/ko/sell-games/how-to/set-up-authentication/) 섹션을 참조해 주세요.\n\n게임 키 판매 절차:\n\n1. [게임 생성](/ko/api/catalog/game-keys-admin/admin-create-game) API 호출을 사용하여 게임을 생성합니다.\n2. 지역 제한을 구성합니다.\n3. [코드 업로드](/ko/api/catalog/game-keys-admin/admin-upload-codes-by-sku) API 호출을 사용하여 게임 키 패키지에 키를 업로드하고 구매가 가능하게 합니다.\n4. [게임 목록 가져오기](/ko/api/catalog/game-keys-catalog/get-games-list) API 호출을 사용하여 사용자의 지역에 맞는 가격이 포함된 게임 카탈로그를 표시합니다.\n5. 주문을 생성합니다. 빠른 구매를 위해 게임 키 SKU를 전달하여 [현재 장바구니의 모든 아이템으로 주문 생성](/ko/api/catalog/payment-client-side/create-order-with-item) API 호출을 사용할 수 있습니다. 응답으로 결제 UI를 열기 위한 토큰이 반환됩니다.\n6. 주문 결제를 위해 결제 UI 열기를 구현합니다.\n\n결제 성공 알림을 실시간으로 받고 사용자에게 아이템을 전달하려면, [웹훅](/ko/webhooks/section/osnovnye-polozheniya) 등을 사용하여 주문 상태 추적을 설정하세요. 키는 사용자가 결제 시 지정한 이메일로 전송되며, 주문 상태가 `done`으로 변경됩니다.\n\n![게임 키](https://cdn.xsolla.net/developers/current/images/api_docs/game-keys.svg)"},"itemId":"game-keys-overview","disableAutoScroll":true,"metadata":{},"compilationErrors":[],"markdown":{"partials":{},"variables":{"rbac":{"teams":["anonymous"]},"user":{},"remoteAddr":{"hostname":"xsolla.redocly.app","port":4000,"ipAddress":"216.73.217.32"},"lang":"ko","env":{"PUBLIC_REDOCLY_BRANCH_NAME":"realm"}}},"pagePropGetterError":{"message":"","name":""}},"slug":"/ko/api/catalog/game-keys-overview","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}