{"templateId":"openapi_docs","sharedDataIds":{"openAPIDocsStore":"oas-@l10n/zh/api/catalog/index.yaml","sidebar":"sidebar-@l10n/zh/catalog-en.sidebars.yaml"},"props":{"definitionId":"@l10n/zh/api/catalog/index.yaml","dynamicMarkdocComponents":[],"baseSlug":"/zh/api/catalog","seo":{"title":"概述","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]},"description":"您可以使用虚拟物品和虚拟货币构建游戏内购商店，并配置其向用户展示的方式。可使用以下商品类型：\n\n* 虚拟物品 — 武器、皮肤、加成道具等游戏内商品。可使用真实货币或虚拟货币销售。\n* 虚拟货币 — 用于购买虚拟物品的游戏内货币。可使用真实货币或虚拟货币销售。\n* 虚拟货币套餐 — 固定数量的虚拟货币。可使用真实货币或虚拟货币销售。\n\n组(Group)用于组织商品目录中的商品。通过组，您可以按逻辑对商品进行分组，并管理商品的显示方式。\n\n使用<b>管理</b>子部分中的API调用来创建、更新和删除商品。\n\n使用<b>商品目录</b>子部分中的API调用获取商品列表，并向用户展示商品。\n\n<div class=\"notice\">\n  <b>提示</b><br><br>\n    请勿使用<b>管理</b>子部分中的API调用来构建商店商品目录。\n</div>\n\n<br>\n\n<div class=\"note\">\n  <b>注：</b><br><br>\n    <a href=\"https://developers.xsolla.com/zh/api/catalog/virtual-items-currency-catalog/get-virtual-items\" target=\"_blank\">获取虚拟物品列表</a>API调用会返回详细的商品数据，包括价格和属性，并支持分页。请使用该调用在商店前端显示商品目录页面。\n    <br><br>\n    <a href=\"https://developers.xsolla.com/zh/api/catalog/virtual-items-currency-catalog/get-all-virtual-items\" target=\"_blank\">获取所有虚拟物品列表</a>API调用会返回商品SKU、名称、描述，以及组ID和组名称，且不分页。请将其用于客户端侧搜索或索引。\n</div>\n\n<br>\n\n如需使用虚拟货币的购买，请使用[使用以虚拟货币购买的指定商品创建订单](/zh/api/catalog/virtual-payment/create-order-with-item-for-virtual-currency) API调用。无需支付UI⸺扣款会在执行API调用时完成。\n\n<b>使用虚拟货币购买流程示例：</b>\n\n![使用虚拟货币购买流程示例](https://cdn.xsolla.net/developers/current/images/api_docs/virtual-items-currency-overview.png)"},"itemId":"virtual-items-currency-overview","disableAutoScroll":true,"metadata":{},"compilationErrors":[],"markdown":{"partials":{},"variables":{"rbac":{"teams":["anonymous"]},"user":{},"remoteAddr":{"hostname":"xsolla.redocly.app","port":4000,"ipAddress":"216.73.216.14"},"lang":"zh","env":{"PUBLIC_REDOCLY_BRANCH_NAME":"realm"}}},"pagePropGetterError":{"message":"","name":""}},"slug":"/zh/api/catalog/virtual-items-currency-overview","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}