> ## 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.109.0 (21 يوليو 2026)

> لوحة تحكم Analytics v3 أُعيد بناؤها بالكامل، مع إيرادات فورية، ومقارنات للفترات بنقرة واحدة، وتخطيطات قابلة للتخصيص، وبطاقات مخططات قابلة للمشاركة — بالإضافة إلى التجارب المدفوعة للاشتراكات وCheckout، ومنع إساءة استخدام التجارب، وPayout Accounts لإدارة حسابات بنكية متعددة، وتسعير المنتجات والإضافات بأي عملة قابلة للتحصيل، وWebhook جديد باسم subscription.update_payment_method، وتسجيل الدخول الاجتماعي الأصلي في تطبيق الهاتف المحمول.

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

### 1. **Analytics v3 — لوحة تحكم أُعيد بناؤها بالكامل**

أعدنا بناء Analytics بالكامل من الصفر. تجمع لوحة التحكم الآن كل المقاييس المهمة في مكان واحد، بدعم من محرك بيانات فوري جديد (**Analytics v3**).

<Frame>
  <img src="https://mintcdn.com/dodopayments/0CMGO15EywCgJkDq/images/analytics/analytics-v3.png?fit=max&auto=format&n=0CMGO15EywCgJkDq&q=85&s=10e0adb16fea47972cf13a4afe709859" alt="لوحة Home المُعاد تصميمها والمدعومة من Analytics v3" style={{ maxHeight: '500px', width: 'auto' }} width="1888" height="1015" data-path="images/analytics/analytics-v3.png" />
</Frame>

**كل شيء في مكان واحد**

* **الإيرادات الفورية** — اطّلع على إيرادات اليوم لحظة بلحظة، ساعة بساعة.
* **المقارنات بنقرة واحدة** — قارن أي مقياس بالفترة السابقة، مثل الشهر الماضي، بنقرة واحدة.
* **الإيرادات حسب البلد** — تعرّف بدقة على البلدان التي تأتي منها إيراداتك.
* **صحة المدفوعات** — تتبّع المدفوعات الفاشلة والمبالغ المستردة والمدفوعات المستعادة معًا في عرض واحد.
* **رؤى الاشتراكات** — تتبّع فِئات الاحتفاظ وMRR ومعدل التوقف عن الاشتراك بشكل مدمج.

هناك أمران نفخر بهما بشكل خاص:

1. **تخطيط قابل للتخصيص.** اسحب الأدوات وأفلتها واختر المقاييس التي تظهر — هذه لوحتك وبطريقتك. يُحفظ التخطيط تلقائيًا.
2. **بطاقات مخططات قابلة للمشاركة.** انقر على **مشاركة** في أي مقياس، واختر سمة ألوان، وأضف شعارك، ونزّل صورة جاهزة للنشر — مثالية لتحديثات المستثمرين أو تقارير الفريق، من دون الحاجة إلى أداة تصميم.

تعرّف على المزيد: [تحليلات لوحة التحكم](/features/analytics-and-reporting)

### 2. **التجارب المدفوعة للاشتراكات وCheckout**

لم يعد من الضروري أن تكون التجارب مجانية. يمكنك الآن تحصيل **مبلغ تجربة** على السعر المتكرر لمنتج الاشتراك، بحيث يدفع العملاء رسومًا مقدّمة مخفّضة خلال فترة التجربة، قبل تطبيق السعر الكامل عند أول تجديد.

<Frame>
  <img src="https://mintcdn.com/dodopayments/xWy-mQaJKoU2V22s/images/subscriptions/paid-trials.png?fit=max&auto=format&n=xWy-mQaJKoU2V22s&q=85&s=e7d6749e11cc3f8bfa45906d970fd606" alt="نموذج تسعير الاشتراك مع مدة تجربة ومبلغ تجربة اختياري لتجربة مدفوعة" style={{ maxHeight: '500px', width: 'auto' }} width="1014" height="809" data-path="images/subscriptions/paid-trials.png" />
</Frame>

* عيّن `trial_amount` إلى جانب `trial_period_days` على سعر متكرر — تتطلب التجربة المدفوعة فترة تجربة موجبة.
* اختر ما إذا كانت خصومات Checkout تنطبق على رسوم التجربة (`trial_apply_discounts`)، بحيث يمكن خصم مبلغ التجربة المدفوعة أو تحصيله كاملًا بشكل مستقل عن السعر المتكرر.
* تمر التجارب المدفوعة عبر **Checkout** أيضًا: تُفرض الضرائب على مبلغ التجربة ويظهر في حسابات checkout-session وتسعير payment-link، مع تطبيق هامش Adaptive Currency لكل عملة.

لم تتغير التجارب المجانية — يؤدي ترك مبلغ التجربة دون تعيين إلى الإبقاء على السلوك الحالي، حيث تكون أول دفعة هي `0` وتحدث عند انتهاء التجربة.

تعرّف على المزيد: [الاشتراكات](/features/subscription) | [Checkout Session](/developer-resources/checkout-session)

### 3. **منع إساءة استخدام التجارب في الاشتراكات**

يمنع إعداد **منع إساءة استخدام التجارب** الجديد، المتاح اختياريًا، العملاء من المطالبة بالتجارب بشكل متكرر للنشاط التجاري نفسه. عند تفعيله، يتم تلقائيًا تحويل العميل الذي سبق له استرداد تجربة — وفقًا للبريد الإلكتروني المُطبّع (بعد إزالة الأسماء المستعارة باستخدام +) — إلى **عملية شراء مدفوعة بلا تجربة** بدلًا من منحه تجربة جديدة.

<Frame>
  <img src="https://mintcdn.com/dodopayments/xWy-mQaJKoU2V22s/images/subscriptions/prevent-trial-misuse.png?fit=max&auto=format&n=xWy-mQaJKoU2V22s&q=85&s=954fb3e74985d71017cbfc18fbf09e04" alt="مفتاح منع إساءة استخدام التجارب في علامة تبويب إعدادات الاشتراكات" style={{ maxHeight: '500px', width: 'auto' }} width="1898" height="1006" data-path="images/subscriptions/prevent-trial-misuse.png" />
</Frame>

فعّله من علامة تبويب **الاشتراكات** في إعدادات لوحة التحكم. يكون الإعداد **متوقفًا افتراضيًا**، وتُسجّل عمليات الاسترداد عند تفعيل التجربة (لذلك يستهلك الإلغاء في اليوم نفسه التجربة أيضًا)، كما تتم إضافة العملاء الحاليين بأثر رجعي من التجارب السابقة بناءً على البريد الإلكتروني.

تعرّف على المزيد: [الاشتراكات](/features/subscription)

### 4. **Payout Accounts**

يمكنك الآن إدارة **حسابات بنكية متعددة لتحويل الدفعات** من لوحة التحكم بدلًا من حساب ثابت واحد. أضف حسابات لكل عملة وطريقة تحويل، واحفظ المسودات، وأعد إرسال الحسابات المعلّقة، وشاهد الحساب النشط وأي سبب للتعليق أو الفشل داخل الصفحة.

<Frame>
  <img src="https://mintcdn.com/dodopayments/eH3qSTsrWihVdlv7/images/payouts/payout-page.png?fit=max&auto=format&n=eH3qSTsrWihVdlv7&q=85&s=c4011d2daa64e6e6730a37c806c159e0" alt="صفحة Payouts التي تعرض الرصيد المؤهل للتحويل وإعدادات الجدول والحسابات البنكية المرتبطة وسجل تحويلات الدفعات" style={{ maxHeight: '500px', width: 'auto' }} width="1638" height="1017" data-path="images/payouts/payout-page.png" />
</Frame>

* يتم تفعيل أول حساب تتم الموافقة عليه تلقائيًا، بينما تعرض الحسابات المعلّقة أو الفاشلة السبب داخل الصفحة مع إجراء لإعادة الإرسال.
* أصبح التحقق البنكي أثناء إعداد النشاط التجاري يعتمد الآن على تدفق Payout Accounts نفسه، لتوفير تجربة موحّدة.

تعرّف على المزيد: [عملية Payouts](/features/payouts/payout-structure) | [الأرصدة](/features/account-summary-payout-wallet)

### 5. **تسعير المنتجات والإضافات بأي عملة قابلة للتحصيل**

يمكن الآن تعيين **الأسعار الأساسية** للمنتجات والإضافات بأي عملة يمكن لـ Dodo Payments تحصيلها، وليس USD فقط. تتضمن نماذج التسعير محدد عملات قابلًا للبحث مع أعلام البلدان، كما تُثبّت العملات الأكثر شيوعًا — **USD وGBP وEUR وINR** — في أعلى القائمة المنسدلة.

لا يزال يتم تحصيل الرسوم من كل من هم خارج عملتك الأساسية عبر Adaptive Currency، لكن أصبح لديك الآن كامل الحرية في إنشاء الأسعار بالعملة الأنسب لسوقك.

تعرّف على المزيد: [المنتجات](/features/products) | [الإضافات](/features/addons) | [Adaptive Currency](/features/adaptive-currency)

### 6. **Webhook جديد: `subscription.update_payment_method`**

يتم إطلاق حدث **Webhook باسم `subscription.update_payment_method`** جديد كلما تغيّرت طريقة دفع الاشتراك — مثلًا عندما ينتقل العميل إلى بطاقة محفوظة أخرى. ويحمل حمولة Subscription، حتى تتمكن من إبقاء سجلاتك متزامنة من دون استخدام polling.

الحدث إضافي ويظهر تلقائيًا في endpoints الحالية لـ Webhook.

تعرّف على المزيد: [أحداث Webhook](/developer-resources/webhooks/intents/webhook-events-guide)

### 7. **تسجيل الدخول الاجتماعي الأصلي في تطبيق الهاتف المحمول**

يدعم تطبيق Dodo Payments للهاتف المحمول الآن **تسجيل الدخول الاجتماعي الأصلي** — سجّل الدخول باستخدام **Google** أو **GitHub** عبر جلسة مصادقة النظام الآمنة على جهازك بدلًا من كتابة البريد الإلكتروني وكلمة المرور. يستخدم تبادل OAuth بروتوكول **PKCE (S256)** المرتبط بـ nonce للحالة لكل طلب، لذلك يكون تسجيل الدخول أسرع ومحميًا بشكل أفضل من حقن التعليمات البرمجية وCSRF. يتوفر التدفق نفسه أيضًا في تطبيق سطح المكتب.

## التحسينات وإصلاحات الأخطاء

### 8. **`next_billing_date` في معاينة Checkout Session**

تعيد **معاينة** checkout session الآن قيمة `next_billing_date` عندما تحتوي السلة على منتج اشتراك، بحيث يمكنك عرض تاريخ الفوترة القادم قبل إنشاء الاشتراك. ويتم حسابها نسبةً إلى الوقت الحالي (`now + trial period` عند تطبيق تجربة، وإلا `now + one payment frequency`)، ولا تُدرج للسلات التي تحتوي على منتجات تُشترى مرة واحدة فقط.

تعرّف على المزيد: [معاينة Checkout Sessions](/developer-resources/checkout-session) | [معاينة Checkout](/api-reference/checkout-sessions/preview)

### 9. **تصفية الاشتراكات حسب `cancel_at_next_billing_date`**

يقبل `GET /subscriptions` الآن عامل تصفية **`cancel_at_next_billing_date`**، بحيث يمكنك عرض الاشتراكات المجدولة للإلغاء فقط عند نهاية فترتها الحالية (أو استبعادها).

تعرّف على المزيد: [عرض قائمة الاشتراكات](/api-reference/subscriptions/get-subscriptions-1)

### 10. **نسخ تصميم Checkout من وضع الاختبار إلى الوضع المباشر**

يمكنك الآن **نسخ تصميم Checkout المخصص من وضع الاختبار إلى الوضع المباشر** في خطوة واحدة، مع تغطية جميع أسطح التصميم وهوية المتجر — ولن تحتاج بعد الآن إلى إعادة إنشاء نسقك يدويًا عند الانتقال إلى الوضع المباشر.

تعرّف على المزيد: [Storefront](/features/storefront)

### 11. **مسودات المنتجات لكل وضع**

يحتفظ إنشاء المنتجات الآن **بمسودات منفصلة لوضع الاختبار والوضع المباشر**، مع خيار **مسح المسودة**، لذلك لن يتداخل المنتج قيد الإنشاء في أحد الوضعين مع الوضع الآخر. كما أُضيفت أزرار إجراءات في العنوان إلى صفحات نماذج المنتجات والمجموعات لتسريع عمليات الحفظ.

تعرّف على المزيد: [المنتجات](/features/products)

### 12. **جميع حقول List API كأعمدة جداول قابلة للتحديد**

تعرض جداول لوحة التحكم الآن **كل حقل تُعيده List API الأساسية** كعمود قابل للتحديد، مع قائمة قابلة للتمرير للتحكم في ظهور الأعمدة وتسميات مفهومة — حتى تتمكن من إظهار البيانات التي تحتاجها بالضبط دون فتح كل سجل.

### 13. **إمكانية الوصول باستخدام لوحة المفاتيح عبر لوحة التحكم وCheckout**

أجرينا مراجعة شاملة لإمكانية الوصول عبر **لوحة التحكم وCheckout وcheckout SDK**: وصول متسق باستخدام لوحة المفاتيح ووضوح حالة التركيز، وأسماء يمكن الوصول إليها لعناصر التحكم والأدوات، واتفاقية موحّدة للتركيز والأخطاء في عناصر النماذج ومربعات الاختيار وأزرار الاختيار والمفاتيح وعلامات التبويب والأزرار.

### إصلاحات وتحسينات أخرى

* **إصلاح تعطل Checkout** الناتج عن ترجمة الصفحة داخل المتصفح (مثل Google Translate)، والتي كان من الممكن أن تزيل عقد DOM التي لا يزال React يديرها.
* **تحسين الملء التلقائي للعناوين** في Checkout، وإعادة بنائه باستخدام Google Places API (New) حتى تبقى اختيارات القائمة المنسدلة بعد فقدان التركيز، أو طي لوحة المفاتيح، أو إعادة التموضع.
* إصلاحات بسيطة للأخطاء وتحسينات في الاستقرار عبر المنصة.