v1.66.0（2025年12月8日）

Subscription.updated webhook，最小地址结账，只读API密钥，UPI自动支付和RuPay订阅适用于所有企业

​

新功能 🚀

1. subscription.updated Webhook
   一个新的 webhook 事件在每次订阅对象更新时触发，为你提供有关任何订阅更改的实时通知。

   使用此 webhook：

   • 在订阅详细信息发生更改时立刻收到通知
   • 让你的应用状态与 Dodo Payments 保持同步
   • 无需轮询 API 即可对订阅更新作出响应
   订阅 subscription.updated，可消除轮询需求，并确保系统与实时订阅更改保持同步。

   了解详情：Subscription Webhooks

2. 结账中的最小地址支持

   

   通过新的最简地址收集模式降低结账摩擦。与其收集完整地址信息，最简地址模式仅收集：

   • 国家/地区：始终需要以进行税务判断
   • 邮政编码/ZIP 码：仅在需要用于销售税、增值税或 GST 计算的地区收集
   结果：客户完成结账的速度显著提升，表单字段更少。

   启用最简地址：

   Checkout Sessions

   const session = await client.checkoutSessions.create({
     product_cart: [{ product_id: 'prod_123', quantity: 1 }],
     minimal_address: true
   });
   

   Static Payment Links

   将 minimalAddress=true 附加到你的支付链接 URL：

   https://checkout.dodopayments.com/buy/prod_123?minimalAddress=true
   
   默认情况下，结账仍会继续收集完整地址。我们将逐步把所有结账链接切换到最简地址模式。现在启用功能标志，即可开始受益于降低的结账摩擦。

3. 只读 API 密钥
   创建具有只读权限的 API 密钥，以实现更安全的集成。创建新 API 密钥时，取消选中 启用写入访问 即可创建只读密钥。

   只读密钥可以：

   • 获取支付、订阅和客户数据
   • 列出产品并检索详情
   • 访问报告与分析

   只读密钥不能：

   • 创建或修改支付
   • 更新订阅
   • 更改产品配置
   对于仪表板集成、分析工具以及任何仅需查看数据而无需修改的系统，请取消勾选“启用写入访问”。

4. UPI 自动支付与 RuPay 卡订阅 - 全量推送
   UPI 自动支付和 RuPay 卡订阅现已向所有商家开放。通过此功能，可实现印度客户的循环支付：

   • UPI 自动支付：通过 UPI 授权自动执行循环扣费
   • RuPay 卡：支持印度本土卡网络的订阅
   结果：为印度市场扩展了订阅支付选项，并实现符合 RBI 要求的授权处理。

   了解更多：Subscriptions with RBI-Compliant Mandates

5. 计划变更预览API
   一个新的API端点，用于在提交之前预览订阅计划变更。获取确切的收费金额，并查看变更后的订阅将如何显示 - 无需进行任何实际修改。

   const preview = await client.subscriptions.previewChangePlan('sub_123', {
     product_id: 'prod_pro_plan',
     proration_billing_mode: 'prorated_immediately',
     quantity: 1
   });
   
   console.log('Charge amount:', preview.immediate_charge.summary);
   console.log('New plan details:', preview.new_plan);
   

   使用此功能可以：

   • 在确认升级/降级之前，向客户准确展示他们将支付的费用
   • 构建定价计算器和计划比较工具
   • 通过提高定价透明度减少支持工单

   了解更多：预览计划变更API

6. 常规错误修复和增强
   此版本包括UI优化、性能改进，并解决了小错误，以提供更可靠、流畅的体验。