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

Checkout Sessions

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

Validate Discount

通过 ID 检查折扣是否有效。

Get Discount by Code

使用代码名称（例如 “SAVE20”）查找并验证折扣。

Create Discount (API)

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

List & Update Discounts

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

​
什么是折扣代码？

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

​
主要好处

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

​
创建折扣代码

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

​
仪表板设置

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

​
结账体验

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

​
API 管理

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

API Reference

查看创建折扣的 API。
列出所有折扣或检索详情以供管理和审计。

API Reference

浏览列表和检索 API。
使用可读代码名称（例如 “SAVE20”）而非内部 ID 查找折扣。

API Reference

按代码名称检索折扣。
修改折扣配置，例如金额、到期时间或限制。

API Reference

了解如何更新折扣详情。
在应用前检查折扣是否有效且适用。

API Reference

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

API Reference

删除折扣。

​
常见用例

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

​
集成示例

​
在结账会话中应用折扣

预先应用折扣并显示代码输入 UI。 
const session = await client.checkoutSessions.create({
  product_cart: [
    { product_id: 'prod_abc', quantity: 1 }
  ],
  discount_code: 'BLACKFRIDAY2024',
  customer: { email: 'user@example.com', 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'
});

​
最佳实践

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