> ## 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 (8 ديسمبر 2025)

> Webhook تحديث الاشتراك، عملية الدفع بعنوان مختصر، مفاتيح API للقراءة فقط، اشتراكات UPI AutoPay و RuPay لجميع الأعمال

## ميزات جديدة 🚀

1. **`subscription.updated` Webhook**\
   حدث ويب هوك جديد يتم تفعيله عند كل تحديث لكائن الاشتراك، مما يوفر لك إشعارات فورية حول أي تغييرات في اشتراكاتك.

   استخدم هذا الويب هوك لـ:

   * الحصول على إشعارات فورية عند تغيير تفاصيل الاشتراك
   * الحفاظ على حالة التطبيق متزامنة مع Dodo Payments
   * الاستجابة لتحديثات الاشتراك دون الاستعلام المتكرر عن واجهة برمجة التطبيقات

   <Tip>
     Subscribe to `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>

   قلل الاحتكاك في صفحة الدفع بوضع جمع العناوين البسيط الجديد. بدلاً من جمع تفاصيل العنوان الكاملة، يقوم وضع العنوان البسيط بجمع:

   * **البلد**: مطلوب دائمًا لتحديد الضرائب
   * **الرمز البريدي/الرمز البريدي الوطني**: يُجمع فقط في المناطق التي يكون فيها ضروريًا لحساب ضريبة المبيعات أو ضريبة القيمة المضافة أو ضريبة السلع والخدمات

   <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">
       أضف `minimalAddress=true` إلى عنوان رابط الدفع الخاص بك:

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

   <Info>
     بشكل افتراضي، يستمر إتمام الدفع في جمع العناوين الكاملة. سنقوم تدريجيًا بتحويل جميع روابط الدفع إلى وضع العنوان البسيط. فعّل علم الميزة الآن لبدء الاستفادة من تقليل الاحتكاك أثناء الدفع.
   </Info>

3. **مفاتيح واجهة برمجة التطبيقات للقراءة فقط**\
   أنشئ مفاتيح واجهة برمجة التطبيقات بصلاحيات للقراءة فقط لتكامل أكثر أمانًا. عند إنشاء مفتاح جديد، قم بإلغاء تحديد **تمكين الوصول إلى الكتابة** لإنشاء مفتاح للقراءة فقط.

   يمكن لمفاتيح القراءة فقط أن:

   * تجلب بيانات الدفعات والاشتراكات والعملاء
   * تسرد المنتجات وتسترجع التفاصيل
   * تصل إلى التقارير والتحليلات

   لا يمكن لمفاتيح القراءة فقط أن:

   * تنشئ أو تعدل الدفعات
   * تحدّث الاشتراكات
   * تغيّر تكوينات المنتجات

   <Tip>
     قم بإلغاء تحديد "تمكين الوصول إلى الكتابة" لتكاملات لوحة التحكم وأدوات التحليلات وأي نظام يحتاج فقط إلى عرض البيانات دون إجراء تغييرات.
   </Tip>

4. **التحصيل التلقائي عبر UPI واشتراكات بطاقة RuPay - طرح كامل**\
   أصبح التحصيل التلقائي عبر UPI واشتراكات بطاقات RuPay متاحة الآن لجميع الشركات. هذا يتيح الدفعات المتكررة للعملاء الهنود باستخدام:

   * **التحصيل التلقائي عبر UPI**: رسوم متكررة آلية عبر تفويض UPI
   * **بطاقات RuPay**: دعم الاشتراك لشبكة البطاقات المحلية في الهند

   <Check>
     النتيجة: توسيع خيارات دفع الاشتراك للسوق الهندي مع التعامل بتفويضات متوافقة مع بنك الاحتياطي الهندي.
   </Check>

   تعرّف على المزيد: [Subscriptions with RBI-Compliant Mandates](/features/subscription#subscriptions-with-rbi-compliant-mandates)

5. **واجهة برمجة التطبيقات لمعاينة تغيير الخطة**\
   نقطة نهاية جديدة لواجهة برمجة التطبيقات لمعاينة تغييرات خطة الاشتراك قبل الالتزام بها. احصل على المبلغ الدقيق للرسوم وشاهد كيف ستبدو الاشتراك بعد التغيير - دون إجراء أي تعديلات فعلية.

   ```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-reference/subscriptions/preview-change-plan)

6. **إصلاحات وتحسينات عامة**\
   تتضمن هذه النسخة تحسينات في واجهة المستخدم، وتحسينات في الأداء، وحل الأخطاء الطفيفة لتجربة أكثر موثوقية وسلاسة.