> ## Documentation Index
> Fetch the complete documentation index at: https://docs.subotiz.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 商品

<AccordionGroup>
  <Accordion title="Subotiz 中商品和定价方案有什么区别？">
    在 Subotiz 中，商品和定价方案各自承担不同职责。商品用于定义销售内容——例如 SaaS 服务、数字内容或会员订阅——包含商品名称、类型、图片和描述等信息，本身不包含价格信息。定价方案用于设置客户购买该商品的具体收费金额与计费周期。每个定价方案必须绑定一个商品，一个商品可以配置多个定价方案。例如，商品「团队版」可以对应「团队版·月付 \$30」和「团队版·年付 \$300」两个定价方案。
  </Accordion>

  <Accordion title="如果修改了已经有订单或订阅的商品，现有客户会受影响吗？">
    不会。如果商品已被订单、发票或订阅引用，修改后系统会创建新的商品版本（product\_version\_id），而不会修改现有数据。历史订单、发票和订阅保存了原始商品信息快照，会继续引用原有版本。已存在的订阅将按照原商品版本继续续费。只有修改后新创建的订单、结账或订阅才会使用更新后的商品版本。创建新商品版本时，系统会同步生成新的定价版本以确保一致性。
  </Accordion>

  <Accordion title="Subotiz 中商品有哪三种状态？各自代表什么？">
    Subotiz 中商品有三种状态：

    * **已激活** —— 商品已启用，可被定价方案引用、用于生成付款链接并参与结账流程。
    * **未激活** —— 商品已创建但尚未启用，不可参与结账或生成付款链接，但仍可继续编辑并随时激活。
    * **已归档** —— 软删除状态，商品从列表中移除，但历史记录仍可查询。商品归档时，其关联的定价方案将一并归档。已归档商品无法恢复。
  </Accordion>

  <Accordion title="Subotiz 支持哪些商品类型？订阅制在线软件服务应该选哪个？">
    Subotiz 支持九种商品类型：

    * SaaS 订阅
    * 软件（包括 AI 工具）
    * 在线视频内容
    * 信息服务
    * 电子书
    * 数字图形或模板
    * 电子游戏
    * 区块链数字商品
    * 其他数字商品

    对于通过互联网提供、无需本地安装的订阅制软件服务，应选择 SaaS 订阅。SaaS 定义为云端托管、多租户结构、按月或按年周期计费，由服务商负责维护与安全的订阅式软件。商品类型用于后台分类与报表统计，正确选择有助于确保计费逻辑与财务报表的一致性。
  </Accordion>

  <Accordion title="SaaS 订阅和软件这两种商品类型有什么区别？">
    SaaS 订阅和软件都与软件产品相关，但代表截然不同的交付方式和计费模式。SaaS 订阅是通过云端托管、多租户结构在线提供的订阅制软件，无需本地安装，通常按月或按年周期计费，服务商负责维护、更新和安全。软件指可下载或授权安装在用户设备上的软件，通常为一次性购买或永久授权，可附加维护或升级服务。核心区别在于交付方式：云端订阅访问（SaaS）vs 本地安装授权（软件）。
  </Accordion>

  <Accordion title="在 Subotiz 中创建商品需要填写哪些信息？">
    在 Subotiz 中创建商品时，必填字段和可选字段如下：

    * **必填字段：**
      * 商品名称（显示在结账页面和收据中）
      * 商品类型（用于后台分类与筛选）
    * **可选字段：**
      * 商品图片（JPG、PNG 或 WEBP 格式，不超过 2MB）
      * 商品描述（简要说明商品内容）
      * 权益标签（最多20个定量或定性权益）

    商品 ID 由系统自动生成，无需手动输入。权益标签仅在结账页面或发票中展示，不影响实际计费逻辑或使用限制。
  </Accordion>

  <Accordion title="创建商品时，创建并激活和保存有什么区别？">
    保存新商品时有两种选项：

    * **创建并激活** —— 会立即启用商品，使其可用于定价配置、结账流程和发票生成。
    * **保存** —— 将商品以未激活状态保存，仅用于后台管理。未激活商品不会出现在定价配置中，不可用于新订单结账，但可以继续编辑并随时激活。

    如果暂时还不需要开放结账，选择保存，待需要时再激活即可。
  </Accordion>

  <Accordion title="商品权益标签是什么？会影响计费或使用限制吗？">
    Subotiz 中的商品权益标签是添加到商品上的描述性内容，用于向客户说明购买后获得的服务内容。权益标签仅在结账页面或发票中展示，仅供参考。

    支持两种类型：

    * **定量权益** —— 用于有明确数量或次数限制的服务，如课程数量、下载次数或使用额度
    * **定性权益** —— 用于仅描述服务内容、不涉及具体数量的权益，如会员访问权限、社区论坛权限或专属服务

    每个商品最多支持添加20个权益标签。重要提示：权益标签不影响计费逻辑、使用限制或任何系统层面的控制，仅用于信息展示。
  </Accordion>

  <Accordion title="停用商品后，商品关联的定价方案会怎样？">
    停用商品时，该商品下所有关联的定价方案将一并停用。商品变为未激活状态，定价方案无法再用于新的结账流程或订单，也无法生成新的付款链接。但历史订单保持不变，已存在的订阅仍按原条款继续续费。如果之后需要重新使用该商品，可以重新激活，其定价方案也需要相应重新激活。
  </Accordion>

  <Accordion title="删除商品后可以恢复吗？历史订单记录会怎样？">
    不可以。商品删除后无法恢复，会从商品列表中永久移除。但引用该商品的历史订单记录会被保留，仍可查询——删除操作仅将商品从活跃商品管理界面移除。删除前请确认该商品不再需要，并已查看所有相关业务记录。如果只是不想用于新交易而非永久移除，建议选择停用或归档。
  </Accordion>

  <Accordion title="如果提高了订阅方案的价格，现有订阅用户会被收取新价格吗？">
    不会。定价方案的修改仅影响后续新交易，不影响已有订单或有效订阅。例如将月费从 \$30 调整为 \$40 后，现有订阅用户仍按 \$30 续费，修改后新创建的订阅则按 \$40 计费。这一机制确保现有客户不会因价格调整受到意外影响，同时允许商家立即为新客户应用新价格。
  </Accordion>

  <Accordion title="如果下架某个定价方案，现有订阅用户还能继续使用吗？">
    可以。当定价方案被停用或归档后，已在该方案下的订阅用户不受影响，可以继续使用并正常续费。下架定价方案只意味着新用户无法在结账时选择该方案。这一机制确保现有客户的业务连续性，同时允许商家逐步停止向新用户提供旧定价选项。
  </Accordion>

  <Accordion title="Subotiz 定价方案支持哪两种收费方式？">
    Subotiz 定价方案支持两种收费方式：

    * **周期性订阅** —— 适用于持续收费的订阅服务，如 SaaS 月费或年费，支持试用期（免费或付费）、前期自定义定价以及自动续费。
    * **单次付费** —— 适用于一次性收费场景，如服务开通费或终身授权，仅收取一次费用，不产生周期性续费或订阅。

    同一商品可以同时配置周期性订阅和单次付费两种定价方案。
  </Accordion>

  <Accordion title="归档定价方案后，该方案上的现有订阅还会继续续费吗？">
    会。归档定价方案会阻止其被用于新的订单、订阅或结账，但不影响已存在的有效订阅。已在该方案下的订阅将继续按照原定价配置续费。历史订单和发票同样保持不变。归档后的方案不再显示于列表页面，也无法通过搜索查找，但所有关联的历史数据仍可查询。
  </Accordion>

  <Accordion title="固定定价订阅方案中，免费试用和付费试用有什么区别？">
    两种试用类型都会推迟首次正式订阅扣费，但区别在于试用期本身是否收费：

    * **免费试用** —— 试用期间不收费，试用结束后系统自动按标准订阅价格开始计费。例如，5月1日开始7天免费试用，首次扣费日期为5月8日。
    * **付费试用** —— 在试用期间按设定的试用价格收费，试用结束后自动切换为标准周期性计费。例如，7天试用收取\$5，之后按月标准价格扣费。

    两种试用类型均支持设置每位客户仅可享受一次试用，避免重复使用。
  </Accordion>

  <Accordion title="固定定价订阅方案中，前期定价是如何运作的？前期定价结束后会怎样？">
    固定定价订阅方案中的前期定价允许为早期计费周期设置最多三条自定义价格规则，按顺序依次应用后恢复标准价格。每条规则需要设置周期区间（如第1–2期），区间必须连续且不可重叠。前期定价结束后，系统自动按标准价格继续计费，无需手动操作。例如：第1–2期 \$50，第3–4期 \$75，第5期起恢复标准价格 \$100。
  </Accordion>

  <Accordion title="周期性订阅定价方案支持哪些计费周期？">
    Subotiz 周期性订阅定价方案支持四种计费周期：

    * 每周（7天）
    * 每月（31天）
    * 每季（93天）
    * 每年（365天）

    系统会按所选周期自动扣费。对于套餐定价方案，还可选择客户发起支付选项，关闭自动续费，由客户手动发起每次支付。
  </Accordion>

  <Accordion title="套餐定价方案是什么？什么时候应该选套餐定价而不是固定定价？">
    套餐定价方案是一种基于每个计费周期内预设数量或捆绑内容进行计费的周期性订阅模式，而非仅基于固定价格。适用于每个周期包含固定使用量的商品，如课程包（每月10节课）、下载次数包或积分套餐。固定定价方案更适合价格稳定且无数量差异的商品。核心区别在于：套餐定价需要定义每周期的包含数量，而固定定价仅定义每周期的收费金额，不涉及使用量。
  </Accordion>

  <Accordion title="用量计费（单价制）中，按周期出账和按阈值出账有什么区别？">
    两种模式都用于按单价计费，但区别在于发票的生成时机：

    * **按周期出账** —— 在固定计费周期（周/月/季/年）内累计使用量，周期结束时系统根据总使用量自动生成发票，无需设置阈值。
    * **按阈值出账（Threshold billing）** —— 费用持续累计，不依赖固定周期结束，当累计费用达到设定阈值（如 \$50）时自动生成发票，出账后重新开始新的累计周期，需要设置阈值。

    按周期出账适合需要规律性出账的场景，按阈值出账适合使用量较大、希望比完整计费周期更频繁出账的场景。
  </Accordion>

  <Accordion title="阶梯价格中，批量计价和分段计价有什么区别？">
    两种模式都是按不同用量区间设定单价的阶梯定价模型，但计费方式不同：

    * **批量计价** —— 账单周期内的所有用量按总用量所属区间的统一单价计算。例如客户使用450 GB，落入第2档（101–500 GB，\$0.15/GB），所有450 GB均按 \$0.15 计费，总计 \$67.50。
    * **分段计价** —— 用量按各区间分别计费。同样示例：前100 GB按 \$0.20 = \$20.00，后350 GB按 \$0.15 = \$52.50，总计 \$72.50。

    批量计价更简单，达到高档位后通常费用更低。分段计价更精细，按实际用量分段递减计价。
  </Accordion>

  <Accordion title="定价方案的未激活和已归档状态有什么区别？">
    两种状态都会使定价方案无法用于新订单，但在可见性和可恢复性上有所不同：

    * **未激活** —— 定价方案无法用于新的结账或发票流程，但仍显示在定价列表中，可通过搜索查找，并可随时重新激活。已有订单和订阅不受影响。
    * **已归档** —— 定价方案从默认列表中永久移除，无法通过搜索查找，不可用于新订单或结账。但历史订单、订阅和相关数据仍可查询。归档通过定价管理界面的删除操作触发。

    如果以后可能重新使用，选择未激活；如果永久停用，选择归档。
  </Accordion>

  <Accordion title="为什么无法为定价方案生成支付链接？需要先完成哪些设置？">
    无法生成支付链接通常有两个原因：

    1. 定价方案必须处于已激活状态——分享商品功能仅在定价方案已激活时可用，未激活或已归档的方案无法使用分享功能。
    2. 必须完成 Webhook 配置才能生成支付链接——如果不存在已激活的 Webhook，系统将提示无法生成支付链接。

    解决方法：激活定价方案，并参照 Webhooks｜为支付链接快速配置 完成 Webhook 设置。
  </Accordion>

  <Accordion title="可以在同一个商品下同时创建订阅方案和单次付费方案吗？">
    可以。Subotiz 中一个商品可以同时支持多种不同收费方式的定价方案。例如，可以在同一商品下配置周付订阅、月付订阅和终身一次性付费三种方案。每个定价方案独立运行——客户在每次结账时选择其中一个方案，订单、发票和订阅基于所选方案生成。这样无需为不同计费方式重复创建商品。注意：单次付费方案不涉及试用期和计费周期，这两个字段不会显示。
  </Accordion>

  <Accordion title="客户在结账时问为什么看不到具体收费金额？">
    用量计费方案（单价制或阶梯价格）在结账页面不会显示固定应付金额，这是系统的预期行为。由于费用基于实际使用量计算，在计费周期结束或达到计费阈值前无法确定最终金额，因此结账时无法展示固定收费。结账页面会展示计费方式（基于用量计费）、计费周期（如适用）以及单价信息（如每次费用或每单位价格）。建议在定价方案描述中清晰说明计费规则，帮助客户在订阅前了解收费方式。
  </Accordion>

  <Accordion title="套餐定价中的客户发起支付是什么意思？和普通订阅有什么区别？">
    客户发起支付是套餐定价方案中的一个选项，启用后会关闭自动续费。在普通周期性订阅中，系统会在每个计费周期结束时自动扣款，无需客户操作。选择客户发起支付后，系统不会自动续费，需要客户手动发起每次支付才能继续订阅。该选项适用于希望客户主动确认每个计费周期而非被动自动扣费的场景。注意：该选项仅适用于套餐定价方案，固定定价方案和用量计费方案不支持此选项。
  </Accordion>

  <Accordion title="我修改了一个已有订阅的定价方案，现有订阅会用新价格还是旧价格？">
    已有的有效订阅将继续使用原始价格，不受修改影响。当一个已产生交易或订阅的定价方案被修改时，系统会自动创建新的价格版本（price\_version\_id）以保护历史数据。已有订阅继续按照原价格版本计费，修改后新创建的订单和订阅才会使用新版本价格。如需确认某笔订单或订阅使用的具体定价，可进入其详情页查看当时生效的计费配置。
  </Accordion>

  <Accordion title="我的商品很多，在 Subotiz 里怎么快速找到特定商品？">
    商品管理页面支持搜索与筛选功能，帮助快速定位商品。可通过关键词搜索商品名称或商品 ID；也可按商品类型（如 SaaS、软件、电子书、信息服务等）或状态（已激活或未激活）进行筛选。多个筛选条件可以组合使用，进一步缩小范围。商品列表中会显示商品名称、商品 ID、商品类型、状态及创建时间。
  </Accordion>

  <Accordion title="商品 ID 可以自己设定吗？还是系统自动生成的？">
    Subotiz 中的商品 ID 由系统自动生成，不支持手动设置或修改。商品 ID 用于系统内部识别，会显示在商品列表和详情页中。如需使用自定义编号，可在商品名称或描述字段中注明。商品 ID 同时支持作为搜索参数，可在商品管理页面通过 ID 快速定位对应商品。
  </Accordion>

  <Accordion title="我想停用某个定价方案，怎么确认它目前是否还有用户在使用？">
    进入 商品 > 商品定价，点击目标定价方案名称进入详情页，可查看该方案的完整配置及关联商品信息。如该方案已产生订单或订阅，停用操作不会影响现有订阅——已有订阅会继续按原条款执行。停用仅会阻止该方案被用于新的结账或订单。如需判断是否仍有活跃订阅，可结合订阅模块筛选对应定价方案进行确认。
  </Accordion>

  <Accordion title="价格表是什么？和单个定价方案的支付链接有什么区别？">
    价格表是一种展示与分发工具，将多个定价方案整合到同一页面，通过单一链接或 iframe 嵌入代码进行分享。与单个定价方案支付链接只展示一种计费选项不同，价格表支持客户在同一页面对比多个方案（如周付、月付、一次性购买），选择后直接完成结账。价格表不会修改原有定价方案的配置，仅作为基于现有已激活定价方案的展示与分发层。
  </Accordion>

  <Accordion title="价格表支持添加哪些类型的定价方案？哪些不支持？">
    价格表仅支持添加状态为已激活的定价方案。

    在定价类型方面，目前仅支持以下两种：

    * 一次性付费方案
    * 周期性订阅中的固定定价方案

    套餐定价和基于用量的定价（单价制和阶梯价格）暂不支持在价格表中展示或使用，无法添加至价格表。
  </Accordion>

  <Accordion title="创建价格表之前需要先完成哪些设置？">
    创建价格表前需要确认两项设置已完成：

    1. 需要至少一个已激活状态的定价方案——价格表只能添加已激活的定价方案。
    2. 必须完成 Webhook 配置。价格表依赖 Webhook 接收支付结果通知，未完成配置时将无法创建价格表。进入 开发者 > Webhooks，创建 Webhook 并填写有效的 Endpoint URL。

    完成配置并启用后即可使用价格表功能。
  </Accordion>

  <Accordion title="价格表中可以添加的定价方案数量有限制吗？">
    有限制。每种计费周期（如每周、每月、每年）在同一价格表中最多支持添加4个定价方案。该限制按计费周期类型分别计算，而非整个价格表的总数。例如，同一价格表中可以有最多4个月付方案和最多4个年付方案。此限制旨在保持页面展示简洁，避免每个周期选项过多影响客户决策。
  </Accordion>

  <Accordion title="归档价格表和删除价格表有什么区别？">
    归档和删除价格表在影响范围和可恢复性上有所不同：

    * **归档** —— 价格表停止用于结账，但仍保留在后台，可随时重新启用。关联的分享链接和嵌入代码同时失效，但列表本身被保留。
    * **删除** —— 价格表被永久移除，所有关联的结账链接和嵌入代码立即失效，且无法恢复，操作不可撤销。

    如果以后可能重新使用，选择归档；确认永久停用才选择删除。
  </Accordion>

  <Accordion title="我已经分享了价格表链接，修改价格表内容后链接还有效吗？">
    有效。编辑价格表内容（如修改名称、标题、描述或展示样式）不会使已分享的结账链接或嵌入代码失效。修改保存后立即生效，现有链接会自动展示更新后的内容。链接仅在价格表被归档或删除后才会失效。如需调整价格表中的定价方案或展示设置，可直接在详情页修改，已分享的链接会自动反映最新配置。
  </Accordion>

  <Accordion title="价格表可以嵌入到我的网站吗？怎么操作？">
    价格表保存并启用后，Subotiz 会自动生成结账链接和 iframe 嵌入代码两种分发方式。如需将价格表嵌入网站，进入价格表详情页，复制 iframe 嵌入代码，将其粘贴至网站页面或第三方落地页的 HTML 中即可。价格表会以内嵌形式展示在页面中，客户可直接在页面内对比方案并完成结账，无需跳转。同一嵌入代码持续有效，直至价格表被归档或删除。
  </Accordion>

  <Accordion title="分享价格表之前可以预览手机端的展示效果吗？">
    可以。在创建或编辑价格表时，Subotiz 提供桌面端与移动端两种布局的预览功能。可以在分享链接或发布嵌入代码之前，确认按钮颜色、字体及整体布局在不同设备上的展示效果是否统一、专业。预览功能在价格表配置页面的展示设置完成后即可使用。
  </Accordion>

  <Accordion title="价格表的名称和标题有什么区别？客户看到的是哪个？">
    价格表名称和标题用途不同，面向的受众也不同。价格表名称是内部管理标签，仅显示在 Subotiz 后台的价格表列表中，方便商家自己识别和管理，客户不会看到。标题是面向客户的展示内容，显示在价格表页面上，例如选择适合您的订阅方案，客户打开分享链接或查看嵌入页面时看到的就是这个标题。创建价格表时，名称用于内部管理，标题用于向客户清晰传达方案信息。
  </Accordion>

  <Accordion title="Subotiz 支持在同一个方案中将固定费用和用量计费组合使用吗（混合定价）？">
    支持。Subotiz 支持混合定价，允许商家在同一个订阅方案中组合不同的定价结构。例如，一个方案可以包含每个计费周期收取的固定基础费用，以及根据实际使用量收取的可变用量费用。这对于有固定底价加变动用量费用的 SaaS 产品非常实用。混合定价可以在后台 商品 > 商品定价 中创建或编辑定价方案时进行配置。
  </Accordion>
</AccordionGroup>