{"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":"지역별 판매 제한을 사용하면 특정 국가 또는 국가 그룹에서 아이템 가용성을 관리할 수 있습니다. 예를 들어 라이선스 제한으로 특정 국가에서만 게임을 판매할 수 있습니다.\n\n제한은 지역을 사용하여 구성합니다. 각 지역은 하나의 `region_id` 식별자 아래 하나 이상의 국가를 그룹화합니다. 아이템을 하나 이상의 지역에 연결할 수 있습니다.\n\n아이템 가용성은 다음과 같이 결정됩니다.\n\n* 아이템에 지역이 지정되지 않은 경우 모든 국가에서 구매할 수 있습니다.\n* 아이템에 지역이 지정되어 있고 사용자의 국가가 해당 지역에 포함된 경우 이 사용자는 해당 아이템을 구매할 수 있습니다.\n* 아이템에 지역이 지정되어 있지만 사용자의 국가가 어느 지역에도 포함되지 않은 경우 이 사용자는 해당 아이템을 구매할 수 없습니다.\n\n**카탈로그** 하위 섹션의 API 호출을 통해 카탈로그를 요청할 때 사용자의 국가는 `country` 매개 변수로 전달됩니다. 이 매개 변수를 전달하지 않으면 사용자의 IP 주소를 기준으로 국가가 결정됩니다.\n\n사용자의 국가는 카탈로그 요청 시와 주문 생성 시 두 번 아이템의 지역과 대조하여 확인됩니다. 구매할 수 없는 아이템은 카탈로그 응답에 포함되지 않으며, 해당 아이템이 포함된 주문은 생성되지 않습니다.\n\n**공통 지역** 그룹의 API 호출을 사용하여 지역을 생성, 업데이트 및 삭제를 진행합니다.\n\n지역별 판매 제한 설정 절차:\n\n1. 국가 목록을 지정하고 [지역 생성](https://developers.xsolla.com/ko/api/catalog/common-regions/admin-create-region/) API 호출을 사용하여 지역을 생성합니다. 응답으로 다음 단계에 필요한 `region_id`가 반환됩니다.\n2. 가상 아이템의 `region_id`를 `regions` 배열에 전달하여 아이템을 [생성](https://developers.xsolla.com/ko/api/catalog/virtual-items-currency-admin/admin-create-virtual-item/)하거나 [업데이트](https://developers.xsolla.com/ko/api/catalog/virtual-items-currency-admin/admin-update-virtual-item/)하고 지역에 연결합니다.\n3. **카탈로그** 하위 섹션의 API 호출(예: [가상 아이템 목록 가져오기](https://developers.xsolla.com/ko/api/catalog/virtual-items-currency-catalog/get-virtual-items) API 호출)을 사용하여 사용자에게 카탈로그를 표시합니다. 사용자의 국가는 `country` 매개 변수로 결정되며, 이 매개 변수를 제공하지 않으면 사용자의 IP 주소를 기준으로 결정됩니다. 사용자의 국가에서 구매할 수 없는 아이템은 카탈로그 응답에 포함되지 않습니다.\n4. 사용자가 아이템 또는 장바구니 결제를 진행하면 주문을 생성합니다:\n * 아이템이 장바구니에 추가된 경우 [특정 장바구니의 모든 아이템으로 주문 생성](https://developers.xsolla.com/ko/api/catalog/payment-client-side/create-order) 또는 [현재 장바구니의 모든 아이템으로 주문 생성](https://developers.xsolla.com/ko/api/catalog/payment-client-side/create-order) API 호출을 사용합니다.\n * 단일 아이템을 바로 구매하는 경우 [특정 아이템으로 주문 생성](https://developers.xsolla.com/ko/api/catalog/payment-client-side/create-order-with-item) API 호출을 사용하고 아이템 SKU를 전달합니다.\n\n 응답에는 결제 UI를 여는 데 사용할 토큰이 포함됩니다.\n\n\n 참고
\n엑솔라는 사용자의 국가가 아이템에 지정된 지역에 포함되어 있는지 확인합니다. 해당 국가가 아이템의 지역에 포함되어 있지 않으면 주문을 생성할 수 없습니다.\n
\n\n
\n\n5. 주문 결제를 위해 결제 UI를 여는 기능을 구현합니다.\n\n"},"itemId":"common-regions","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/common-regions","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}