SuperAPI AI 工具集

discounts-and-promotions

通用与其它

查看项目

更新于 10-15 21:11

技能介绍

用途:在 Dodo Payments 中实现折扣码、优惠券与促销定价,适用于折扣管理、结账应用代码、展示价格前校验代码,以及订阅计划变更时处理折扣。

主要能力:支持百分比与固定金额折扣(百分比以整数表示,1500 即 15%;固定金额用最小货币单位,如美元分)。可设置产品限制、客户资格、生效与过期时间、使用次数上限、订阅计费周期数限制。结账时可通过 discount_codes 传入多个代码,按顺序叠加,最多 20 个。

使用方式:通过 SDK 调用 client.discounts.create/list/retrieve/retrieveByCode/update/delete 管理折扣;结账时在 checkoutSessions.create 中传入 discount_codes;订阅计划变更时通过 subscriptions.changePlan 的 discount_codes 参数与折扣的 preserve_on_plan_change 设置控制保留、替换或清除。客户资格需先以 customer_eligibility: 'specific' 创建,再通过折扣-客户端点附加客户。

限制与注意:文档称当前仅支持百分比折扣,但 OpenAPI 同时定义固定金额类型,遇到异常需向 Dodo 确认。代码区分大小写。务必在服务端校验,不可仅依赖客户端。传入空数组会清除所有折扣,省略参数才会保留 preserve_on_plan_change 为 true 的折扣。subscription_cycles 仅适用于订阅,与 expires_at 含义不同。

适用场景:折扣码管理、结账优惠、订阅升降级折扣处理、折扣未生效或叠加异常排查。