> ## 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.

# v1.66.0（2025年12月8日）

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

## 新功能 🚀

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

   使用此 webhook：

   * 在订阅详细信息发生更改时立刻收到通知
   * 让你的应用状态与 Dodo Payments 保持同步
   * 无需轮询 API 即可对订阅更新作出响应

   > [!TIP]
   >
   > 订阅 `subscription.updated`，可消除轮询需求，并确保系统与实时订阅更改保持同步。

   了解详情：[Subscription Webhooks](/developer-resources/webhooks/intents/subscription.md)

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

   ![结账中的简化地址支持](https://mintcdn.com/dodopayments/7dyPZdWH7JucnLrT/images/changelog/minimal-address.png?fit=max\&auto=format\&n=7dyPZdWH7JucnLrT\&q=85\&s=cd0e5d6f8c32e052c7ab93a88d841fb8)

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

   * **国家/地区**：始终需要以进行税务判断
   * **邮政编码/ZIP 码**：仅在需要用于销售税、增值税或 GST 计算的地区收集

   > [!TIP]
   >
   > 结果：客户完成结账的速度显著提升，表单字段更少。

   **启用最简地址：**

   **Checkout Sessions**

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

   **Static Payment Links**

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

   ```
   https://checkout.dodopayments.com/buy/pdt_123?minimalAddress=true
   ```

   > [!NOTE]
   >
   > 默认情况下，结账仍会继续收集完整地址。我们将逐步把所有结账链接切换到最简地址模式。现在启用功能标志，即可开始受益于降低的结账摩擦。

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

   只读密钥可以：

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

   只读密钥**不能**：

   * 创建或修改支付
   * 更新订阅
   * 更改产品配置

   > [!TIP]
   >
   > 对于仪表板集成、分析工具以及任何仅需查看数据而无需修改的系统，请取消勾选“启用写入访问”。

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

   * **UPI 自动支付**：通过 UPI 授权自动执行循环扣费
   * **RuPay 卡**：支持印度本土卡网络的订阅

   > [!TIP]
   >
   > 结果：为印度市场扩展了订阅支付选项，并实现符合 RBI 要求的授权处理。

   了解更多：[Subscriptions with RBI-Compliant Mandates](/features/subscription.md#subscriptions-with-rbi-compliant-mandates)

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

   ```javascript theme={null}
   const preview = await client.subscriptions.previewChangePlan('sub_123', {
     product_id: 'pdt_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](/api-reference/subscriptions/preview-change-plan.md)

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


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.