> ## 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 AutoPayおよびRuPayサブスクリプション

## 新機能 🚀

1. **`subscription.updated` Webhook**\
   サブスクリプションオブジェクトの更新が発生するたびにトリガーされる新しい webhook イベントで、サブスクリプションに対するあらゆる変更をリアルタイムで通知します。

   この webhook を使うと：

   * サブスクリプションの詳細が変わったときに即座に通知を受け取れる
   * Dodo Payments とアプリケーション状態を同期し続けられる
   * API にポーリングをかけることなくサブスクリプション更新に対応できる

   <Tip>
     `subscription.updated` に登録するとポーリングの必要がなくなり、リアルタイムでのサブスクリプション変更にシステムを同期できます。
   </Tip>

   詳細: [Subscription Webhooks](/developer-resources/webhooks/intents/subscription)

2. **チェックアウトにおける最小住所サポート**

   <Frame>
     <img src="https://mintcdn.com/dodopayments/7dyPZdWH7JucnLrT/images/changelog/minimal-address.png?fit=max&auto=format&n=7dyPZdWH7JucnLrT&q=85&s=cd0e5d6f8c32e052c7ab93a88d841fb8" alt="チェックアウトでの最小住所サポート" style={{ maxHeight: '500px', width: 'auto' }} width="1459" height="817" data-path="images/changelog/minimal-address.png" />
   </Frame>

   新しいミニマルアドレス収集モードにより、チェックアウトの手間を軽減します。住所をすべて収集する代わりに、ミニマルアドレスモードでは以下の項目のみを収集します：

   * **国**：課税判定のために常に必要
   * **郵便番号/ZIP**：販売税、VAT、またはGST の計算に必要な地域のみで収集されます

   <Check>
     結果：顧客にとって入力項目が少なくなり、チェックアウト完了が大幅に高速化されます。
   </Check>

   **ミニマルアドレスを有効化するには：**

   <Tabs>
     <Tab title="Checkout Sessions">
       ```javascript theme={null}
       const session = await client.checkoutSessions.create({
         product_cart: [{ product_id: 'pdt_123', quantity: 1 }],
         minimal_address: true
       });
       ```
     </Tab>

     <Tab title="Static Payment Links">
       支払いリンクの URL に `minimalAddress=true` を追加してください：

       ```
       https://checkout.dodopayments.com/buy/pdt_123?minimalAddress=true
       ```
     </Tab>
   </Tabs>

   <Info>
     デフォルトではチェックアウトは引き続き完全な住所を収集します。すべてのチェックアウトリンクを段階的にミニマルアドレスモードへ移行していきます。すぐに機能フラグを有効化して、チェックアウトの手間軽減の恩恵を受け始めましょう。
   </Info>

3. **読み取り専用 API キー**\
   より安全な統合のために、読み取り専用権限を持つ API キーを作成します。新しい API キーを作成するときに、**書き込みアクセスを有効にする**のチェックを外して読み取り専用キーを作成してください。

   読み取り専用キーでは以下が可能です：

   * 支払い、サブスクリプション、顧客データの取得
   * 製品の一覧表示と詳細の取得
   * レポートや分析へのアクセス

   読み取り専用キーは**できません**：

   * 支払いの作成や変更
   * サブスクリプションの更新
   * 製品構成の変更

   <Tip>
     ダッシュボード連携、分析ツール、またはデータを表示するだけで変更の必要がないシステムでは「書き込みアクセスを有効にする」のチェックを外してください。
   </Tip>

4. **UPI AutoPay & RuPay カードサブスクリプション - 完全展開**\
   UPI AutoPay および RuPay カードのサブスクリプションがすべての事業者で利用可能になりました。これにより、インドのお客様向けに以下を用いた定期課金が可能になります：

   * **UPI AutoPay**：UPI マンダートによる自動定期課金
   * **RuPay カード**：インド国内のカードネットワークによるサブスクリプション対応

   <Check>
     結果：RBI コンプライアンスに準拠したマンダート処理で、インド市場向けのサブスクリプション決済オプションが拡大します。
   </Check>

   詳細: [Subscriptions with RBI-Compliant Mandates](/features/subscription#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)

6. **一般的なバグ修正と改善**\
   このリリースには、UIのポリッシュ、パフォーマンスの改善、およびより信頼性の高い、スムーズな体験のための小さなバグの修正が含まれています。