跳转到主要内容
折扣代码概述封面
折扣代码让您可以进行有针对性的促销和激励。创建百分比或固定金额的折扣，设置限制和到期时间，限制适用产品，并在结账时无缝应用。

结账会话

在托管结账时应用代码，使用 discount_code 和 UI 控件。

验证折扣

在应用之前检查代码是否有效和适用。

创建折扣 (API)

以编程方式创建新的折扣代码。

列出和更新折扣

浏览和管理现有折扣；根据需要更新或删除。

​
什么是折扣代码？

折扣代码是促销令牌，可以在结账时减少订单总额。它们非常适合：
  • 季节性活动：黑色星期五、产品发布或周年庆
  • 获取优惠：首次购买激励或推荐奖励
  • 客户保留：赢回或忠诚奖励给现有客户
  • B2B交易：通过私密代码进行合同或谈判定价

​
主要好处

  • 灵活的折扣：百分比或固定金额折扣
  • 有针对性的控制：按产品和订阅周期限制
  • 活动管理：到期日期和使用限制
  • 无缝结账：通过结账会话支持 UI 字段和 API

​
创建折扣代码

在您的 Dodo Payments 仪表板中创建折扣代码，然后在托管结账或通过 API 中应用它们。

​
仪表板设置

  • 折扣名称（必填）：内部和仪表板显示名称
  • 代码（必填）：客户在结账时输入的字符串
  • 类型和金额（必填）：设置百分比或固定金额值，或使用提供的按钮生成随机代码
  • 到期日期（可选）：代码失效的日期
  • 使用限制（可选）：所有客户的最大兑换总数
  • 产品限制（可选）：限制适用性到选定产品
  • 订阅周期限制（可选）：折扣适用的账单周期数
使用周期限制进行订阅的介绍性定价（例如，“前 3 个月 50% 折扣”）。

​
结账体验

  1. 购物者在结账字段中输入代码。
  2. 适用的折扣会立即应用，金额会更新。
在结账会话中，传递 discount_code 以预先应用代码，并设置 feature_flags.allow_discount_code 以显示输入字段。

​
API 管理

以编程方式创建折扣代码，指定类型和金额。

API 参考

查看创建折扣的 API。
列出所有折扣或检索管理和审计的详细信息。

API 参考

浏览列出和检索的 API。
修改折扣配置，例如金额、到期时间或限制。

API 参考

了解如何更新折扣详细信息。
在应用之前检查折扣是否有效和适用。

API 参考

验证折扣使用情况。
停用或删除不再需要的折扣。

API 参考

删除折扣。

​
常见用例

  • 介绍优惠：新产品的限时发布促销
  • 批量或 B2B：特定产品集的合同折扣
  • 客户保留：在防止流失的工作流程中使用的赢回代码
  • 季节性活动：基于假期或事件的促销

​
集成示例

​
在结账会话中应用折扣

预先应用折扣并显示代码输入 UI。 
const session = await client.checkoutSessions.create({
  product_cart: [
    { product_id: 'prod_abc', quantity: 1 }
  ],
  discount_code: 'BLACKFRIDAY2024',
  customer: { email: '[email protected]', name: 'Jane Doe' },
  return_url: 'https://yoursite.com/return'
});

​
启用折扣输入而不预先应用

让客户在结账时输入代码，而无需提前传递。 
const session = await client.checkoutSessions.create({
  product_cart: [
    { product_id: 'prod_abc', quantity: 1 }
  ],
  feature_flags: {
    allow_discount_code: true
  },
  return_url: 'https://yoursite.com/return'
});

​
最佳实践

  • 清晰命名：使用与活动名称匹配的可识别代码
  • 时间限制：添加到期时间以推动紧迫感并防止滥用
  • 明智范围：限制到特定产品以避免利润流失
  • 提前验证：在确认结账之前检查代码的适用性
  • 监控影响：按活动跟踪使用情况和转化率
折扣代码是获取和保留客户的强大杠杆。首先使用简单、命名明确的优惠，进行彻底验证，并根据表现进行迭代。