Documentation Index
Fetch the complete documentation index at: https://docs.dodopayments.com/llms.txt
Use this file to discover all available pages before exploring further.
新功能
1. 叠加折扣码
现在，结账会话、支付、订阅和计划更改可以通过 discount_codes 数组在单个请求中接受最多20个折扣码。码按照数组顺序应用——第一个符合条件的代码降低基础价格，第二个则降低已打折的价格，以此类推——这样可以叠加活动，而不需要创建定制的组合代码。
const session = await client.checkoutSessions.create({
product_cart: [{ product_id: 'prod_abc', quantity: 1 }],
discount_codes: ['WELCOME10', 'BLACKFRIDAY20'], // applied in this order
customer: { email: 'user@example.com' },
return_url: 'https://yoursite.com/return'
});
| 界面 | 字段 | 最大代码数量 |
|---|
| 结账会话 | discount_codes | 20 |
| 支付 | discount_codes | 20 |
| 订阅 | discount_codes | 20 |
| 计划更改 | discount_codes | 20 |
discount_codes 值 | 效果 |
|---|
| 未提供 | 如果适用于新产品，保留现有的preserve_on_plan_change=true 折扣 |
[] (空数组) | 从订阅中移除所有现有折扣 |
['CODE_A', 'CODE_B', ...] | 用这个叠加集合替换任何现有折扣，以数组顺序应用 |
discounts 数组下返回——每个条目包括 discount_id、position 和 cycles_remaining （用于订阅）。遗留的单一字段 discount_id 已弃用但仍保留用于向后兼容。
单一字段 discount_code 已弃用但仍完全支持——现有集成可以不作修改继续工作。不能与 discount_codes 在同一请求中组合。我们建议在方便时迁移到 discount_codes，即使对于单个代码，也能利用叠加和更丰富的响应格式。
2. 七种新的客户通知邮件
现在，您的客户会自动收到七种新的交易邮件，涵盖退款确认、订阅生命周期里程碑和支付失败。每封邮件可以在 设置 → 通信 下的 客户邮件 部分单独启用或禁用。
选择加入（默认启用）
| 邮件 | 触发时机 |
|---|
| 退款成功 | 退款成功处理，资金返还至客户的过程中 |
| 订阅试用即将结束 | 试用到期前约2天，首次计费将发生 |
| 订阅立即取消 | 订阅立即取消 |
| 订阅设定为下次账单日期取消 | 订阅计划在当前账单期结束时取消 |
| 邮件 | 触发时机 |
|---|
| 支付失败 | 支付尝试失败——如果希望Dodo Payments直接通知客户而不是自己处理，启用此选项 |
| 订阅续订失败 | 订阅续订支付失败，特定触发；而不是附加于常规支付失败邮件的续订支付失败 |
| 即将到来的续订提醒 | 续订前约2天 |
如果您通过网络钩子自行管理客户沟通，请保持选择退出邮件禁用，以避免给客户发送重复的事件通知。
客户邮件与发送给您团队的通知邮件是分开的。禁用客户邮件不会影响您团队对相同事件的通知。
3. Sunbit — 面向美国客户的分期融资
Sunbit 现在可作为“先买后付”的支付方式，让美国客户在结账时将购买拆分为可管理的月度分期付款。
| 特点 | 详情 |
|---|
| 可用性 | 美国 |
| 货币 | USD |
| 最低金额 | $60.00 |
| 最高金额 | $19,999.00 |
| 订阅 | 不支持（仅一次性付款） |
allowed_payment_method_types 中传递 sunbit 以在结账会话中启用此功能：
const session = await client.checkoutSessions.create({
product_cart: [{ product_id: 'prod_123', quantity: 1 }],
allowed_payment_method_types: ['sunbit', 'credit', 'debit'],
return_url: 'https://example.com/success'
});
始终包含 credit 和 debit 作为备用。不符合Sunbit融资条件的客户以及不在60.00–19,999.00范围内的交易将不会显示选项。 4. 结账支付页面大幅改进
结账的支付页面从头到尾进行了大幅重做——布局更紧凑，加载速度更快，验证状态更清晰，卡片输入用户体验得到了精细化。在全球流量中，这些变化共同提升了结账成功率约2-3%。
变化：
- 更流畅的字段交互——自动聚焦，更智能的制表顺序和改进的卡片表单键盘导航
- 更干净的错误和加载状态——内联验证准确显示客户需要操作的位置，替换以前的全表单错误横幅模式
- 更快的渲染——骨架和渐进式水合消除了在慢速网络上短暂的空白状态闪烁
- 移动端优化——点击目标、滚动行为和键盘处理专为移动结账而调优，目前大部分流量已经偏向移动端
不需要进行集成更改。现有的结账会话会自动应用新的支付页面。
5. 产品表单重做
产品的创建、编辑和复制流程围绕一个单一、一致的表单体验从头开始重建。
亮点：
- 实时预览——在您编辑时查看产品在结账和客户门户中的显示情况，与表单并排显示
- 自动保存——草稿会自动保存，因此如果离开页面或丢失选项卡不会丢失您的工作
- Markdown编辑器——产品描述现在支持完整的Markdown编辑器，具有实时渲染、链接预览和内联格式控制
- 复制流程一致性——复制产品打开相同的预填充表单，而不是简化对话框，因此可以在保存副本前调整每个字段
使用复制功能无须重新输入描述、元数据或履行配置即可快速创建现有产品的区域或定价层级变体。
6. 业务设置页面重新设计
设置 → 业务 页面已重新设计，以便更容易扫描配置和更快更新。设置现在分为更清晰的部分，并通过解释性文字描述每个开关的影响。
现有设置没有任何行为改变——仅布局、分组和周围解释得到了改善。
credits_amount 覆盖现在正确传递到GET结账会话和支付链接路线——当一个结账会话或支付链接使用每次结账的 credit_entitlements 覆盖创建时，通过GET获取该会话或链接返回的是产品级默认 credits_amount 而不是被覆盖的值。现在已修复。- 完全退款的支付操作禁用退款动作——一旦支付完全退款，支付页面上的退款按钮将被禁用，并带有工具提示解释原因。以前按钮是活动的，只在提交后返回错误。
- 整个平台的小错误修复和稳定性改进
