{"templateId":"openapi_docs","sharedDataIds":{"openAPIDocsStore":"oas-@l10n/ja/api/catalog/index.yaml","sidebar":"sidebar-@l10n/ja/catalog-en.sidebars.yaml"},"props":{"definitionId":"@l10n/ja/api/catalog/index.yaml","dynamicMarkdocComponents":[],"baseSlug":"/ja/api/catalog","seo":{"title":"概要","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]},"description":"Bundles are sets of items sold as a single unit. A bundle can include virtual items, virtual currency, virtual currency packages, game keys, and other bundles. Use bundles to create starter packs, seasonal offers, and special deals.\n\nUse the following API call groups to work with bundles:\n\n* Use API calls from the <b>Admin</b> subsection to create, update, delete bundles, and manage their visibility.\n* Use API calls from the <b>Catalog</b> subsection to retrieve bundles.\n\nPurchase limits are configured via the `limits` object when creating or updating a bundle. For more information, refer to the [Limits](/ja/api/catalog/limits-overview) overview. You can also configure [regional restrictions](https://developers.xsolla.com/ja/items-catalog/catalog-features/regional-restrictions/) to sell items in specific countries.\n\n<div class=\"note\">\n  <b>Note</b><br><br>\n    For detailed information on configuring bundles, refer to the <a href=\"https://developers.xsolla.com/ja/items-catalog/items-type/bundles/\" target=\"_blank\">Bundles</a> section.\n</div>\n\n<br>\n\n<b>Bundle management scenario:</b>\n\n1. Create a bundle using the [Create bundle](/ja/api/catalog/bundles-admin/admin-create-bundle) API call. To verify the created bundle, use the [Get bundle](/ja/api/catalog/bundles-admin/admin-get-bundle) API call. To retrieve all bundles in the project, use the [Get list of bundles](/ja/api/catalog/bundles-admin/admin-get-bundle-list) API call.\n2. If needed, use the [Update bundle](/ja/api/catalog/bundles-admin/admin-update-bundle) API call to modify the bundle content or settings.\n3. Implement bundle display logic in your storefront using the [Get list of bundles](/ja/api/catalog/bundles-catalog/get-bundle-list), [Get specified bundle](/ja/api/catalog/bundles-catalog/get-bundle), or [Get list of bundles by specified group](/ja/api/catalog/bundles-catalog/get-bundle-list-in-group) API call.\n4. Create an order using the [Cart and payment](/ja/api/catalog/cart-and-payment-overview) section. For example, for a fast purchase you can use the [Create order with specified item](/ja/api/catalog/payment-client-side/create-order-with-item) API call, passing the bundle SKU. The response contains a token for opening the payment UI.\n5. Implement opening the payment UI to pay for the order.\n6. Set up order status tracking, for example using [webhooks](https://developers.xsolla.com/ja/webhooks/overview), to promptly receive data on successfully paid items and grant them to the user.\n\n![Bundle management scenario](https://cdn.xsolla.net/developers/current/images/api_docs/bundles.png)"},"itemId":"bundles-overview","disableAutoScroll":true,"metadata":{},"compilationErrors":[],"markdown":{"partials":{},"variables":{"rbac":{"teams":["anonymous"]},"user":{},"remoteAddr":{"hostname":"xsolla.redocly.app","port":4000,"ipAddress":"185.30.21.18"},"lang":"ja","env":{"PUBLIC_REDOCLY_BRANCH_NAME":"realm"}}},"pagePropGetterError":{"message":"","name":""}},"slug":"/ja/api/catalog/bundles-overview","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}