跳转到主要内容
产品集合允许您将相关产品(例如,入门版、专业版、企业版计划)汇集在一个框架下。可在单一结账中显示所有选项,定义升级/降级路径,并让客户能够直接在客户门户中切换计划。
产品集合结账页面的截图,显示多个产品

关键亮点

  • 基于集合的结构:将相关产品(计划、层级、定价选项)归为一个集合,以便于组织和管理。
  • 一个集合,多个产品:包括多个产品,如入门版、专业版、终身版等,每个产品都有自己的定价模型。
  • 动态结账体验:在一个结账视图中显示集合中的所有产品,让客户选择其首选计划。
  • 商家级控制:在每个集合内启用、禁用和重新排序产品。第一个产品在结账时会自动预选。
  • 生命周期意识:允许客户通过客户门户在同一集合内升级或降级产品。

创建产品集合

产品集合可以从仪表板或通过 API 创建和管理。每个集合充当相关产品的容器。
1

创建集合

定义集合的名称和可选描述。上传一张图片以在结账中直观表示该集合。
产品集合创建表单的截图,显示名称、描述和图片上传字段
集合字段:
  • 名称(必填):集合的显示名称(例如,“SaaS 计划”,“许可证层级”)
  • 描述(可选):在结账中显示的简要说明
  • 图片(可选):集合的视觉品牌标识
2

将产品添加到集合

将现有产品添加到您的集合。产品可以组织成组以便更好地结构化。
产品集合产品页面的截图,显示产品列表以及将其添加到集合的能力
产品组织:
  • :可选择将产品组织为命名组(例如,“每月计划”,“年度计划”)
  • 未分组的产品:没有组的产品在集合级别出现
  • 排序:拖放以设定显示顺序
每个产品只能属于一个集合。如果某个产品已经在另一个集合中,您必须先将其移除。
3

配置排序和可见性

控制集合内产品的显示顺序和可见性。配置选项:
  • 产品状态:在集合内启用或禁用单个产品
  • 显示顺序:拖放以设定产品在结账中出现的顺序
集合中的第一个产品在结账时会自动预选为默认产品。重新排序产品以更改哪个产品默认被选中。

集合结账

集合实现了统一的结账体验,客户可以在一个地方查看和选择所有可用产品。

结账类型

类型描述用例
集合结账显示集合内所有有效产品订阅计划选择、分级定价
单一产品结账仅显示一个特定产品直接购买、促销链接

集合结账体验

使用集合结账时:
  1. 显示所有有效产品:客户可以看到集合中每个启用的产品
  2. 第一个产品预选:集合中的第一个产品会自动被选中
  3. 显示产品详情:每个产品显示其名称、描述和定价
  4. 单一选择:客户选择一款产品进行购买
  5. 标准流程继续:选择后,结账流程将按照所选产品的定价和计费设置进行
产品集合结账页面的截图,显示多个产品
集合结账非常适合订阅业务,您希望客户在购买前进行比较。

API 集成

为集合创建一个结账会话:
const session = await client.checkoutSessions.create({
  product_collection_id: 'pdc_abc123',
  product_cart: [], // Required: pass an empty array for collection checkout
  return_url: 'https://yoursite.com/return'
});

// Redirect customer to the checkout
window.location.href = session.url;
使用 product_collection_id 时,结账会话创建时不能应用折扣代码。如果启用,客户仍可以在结账时输入折扣代码。

客户门户集成

客户可以直接通过客户门户在同一集合内升级或降级产品。

计划管理操作

操作描述商家控制
查看当前计划显示当前产品名称、价格和续订日期始终可用
升级计划移动到同一集合内的高级产品可配置(默认:允许)
降级计划移动到同一集合内的低级产品可配置(默认:允许)
取消完全取消订阅始终可用
产品集合客户门户计划变更界面的截图,显示计划管理操作

升级/降级规则

  • 升级和降级仅在同一集合内的产品之间可用
  • 按基于您的订阅设置应用的比例计算
  • 每次升级、降级或取消都会向商家发送电子邮件通知
产品集合客户门户计划变更界面的截图,显示计划管理操作
客户无法更改为其当前集合外部的产品。为不同的产品线创建独立的集合。

订阅设置

在仪表板的订阅设置部分配置订阅和计划变更的工作方式。
订阅设置页面的截图,显示启用多个订阅和允许订阅更新的切换

可用设置

设置描述默认
允许多个订阅客户可以同时持有多个有效订阅已启用
允许订阅更新客户可以随时通过客户门户升级或降级其现有订阅已禁用
通过客户门户的计划变更默认情况下是禁用的。在您的订阅设置中启用“允许订阅更新”,以允许客户在同一集合内升级或降级产品。

订阅计划变更

了解更多关于比例计算模式和计划变更行为的信息。

管理集合

产品集合只能通过 Dodo Payments 的仪表板创建和管理。
创建、更新和删除集合仅通过仪表板进行。API 提供只读访问以检索集合数据以便于集成。

仪表板操作

  • 创建:设置具有产品和组的新集合
  • 更新:修改名称、描述、图片和产品组织
  • 重新排序:拖放以更改产品的显示顺序
  • 启用/禁用产品:控制哪些产品出现在结账中
  • 删除:移除集合(产品保持存在但未链接)
产品集合仪表板的截图,显示集合管理操作

最佳实践

  • 逻辑分组:按账单间隔(每月/每年)或功能层级(入门版/专业版/企业版)组织产品
  • 战略排序:把最受欢迎或推荐的计划放在第一位,因为它将在结账时预选
  • 使用清晰命名:产品名称应清楚地传达价值差异
  • 支持双向变更:同时允许升级和降级,以便给客户灵活性
  • 考虑比例计算:选择与您的业务模型相一致的比例计算模式
  • 彻底测试:在上线之前验证测试模式下的结账和计划变更流程
您已经准备好创建产品集合,并为客户提供统一的计划选择体验。