{"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번들을 처리하려면 다음 API 호출 그룹을 사용하세요.\n\n* 번들을 생성, 업데이트, 삭제하고 번들의 표시 여부를 관리하려면 관리자 섹션의 API 호출을 사용하세요.\n* 번들을 불러오려면 카탈로그 섹션의 API 호출을 사용하세요.\n\n구매 한도는 번들을 생성하거나 업데이트할 때 `limits` 개체를 통해 구성됩니다. 자세한 내용은 [한도](/ko/api/catalog/limits-overview) 개요를 참조해 주세요. [지역 제한](https://developers.xsolla.com/ko/items-catalog/catalog-features/regional-restrictions/)을 설정하여 특정 국가에서만 아이템을 판매할 수도 있습니다.\n\n\n
참고\n 번들 구성에 대한 자세한 내용은
번들 섹션을 참조해 주세요.\n
\n\n번들 관리 시나리오:\n\n1. [번들 생성](/ko/api/catalog/bundles-admin/admin-create-bundle) API 호출을 사용하여 번들을 생성합니다. 생성한 번들을 확인하려면 [번들 가져오기](/ko/api/catalog/bundles-admin/admin-get-bundle) API 호출을 사용합니다. 프로젝트의 모든 번들을 검색하려면 [번들 목록 가져오기](/ko/api/catalog/bundles-admin/admin-get-bundle-list) API 호출을 사용합니다.\n2. 필요한 경우 [번들 업데이트](/ko/api/catalog/bundles-admin/admin-update-bundle) API 호출을 사용하여 번들 콘텐츠 또는 설정을 수정합니다.\n3. [번들 목록 가져오기](/ko/api/catalog/bundles-catalog/get-bundle-list), [지정한 번들 가져오기](/ko/api/catalog/bundles-catalog/get-bundle) 또는 [지정한 그룹별 번들 목록 가져오기](/ko/api/catalog/bundles-catalog/get-bundle-list-in-group) API 호출을 사용하여 스토어프론트에서 번들 표시 로직을 구현합니다.\n4. [장바구니 및 결제](/ko/api/catalog/cart-and-payment-overview) 섹션을 사용하여 주문을 생성합니다. 예를 들어 빠른 구매의 경우 번들 SKU를 전달하여 [지정한 아이템으로 주문 생성](/ko/api/catalog/payment-client-side/create-order-with-item) API 호출을 사용할 수 있습니다. 응답에는 결제 UI를 여는 데 필요한 토큰이 포함됩니다.\n5. 주문을 결제하기 위해 결제 UI 열기를 구현합니다.\n6. [웹훅](https://developers.xsolla.com/ko/webhooks/overview) 등을 사용하여 주문 상태 추적을 설정하면 성공적으로 결제된 아이템에 대한 데이터를 신속하게 수신하고 사용자에게 제공할 수 있습니다.\n\n"},"itemId":"bundles-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/bundles-overview","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}