> ## 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.78.0 (February 2, 2026)

> تفضيلات الاتصال مع إشعارات الدفع، وحقول مخصصة لجلسات الدفع، ودعم موسع للغات صفحة الدفع

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

### 1. **تفضيلات الاتصال**

تحكم في كيفية تلقي الإشعارات من خلال تفضيلات الاتصال المعاد تصميمها. قم بتكوين إشعارات البريد الإلكتروني والدفع والتطبيق لتتناسب مع سير عملك.

<Frame>
  <img src="https://mintcdn.com/dodopayments/YvuokxDCslyAwOyr/images/communication-preferences/overview.png?fit=max&auto=format&n=YvuokxDCslyAwOyr&q=85&s=f600972c9d588b5427d250073bf15aac" alt="نظرة عامة على تفضيلات التواصل تظهر إعدادات الإشعارات" style={{ maxHeight: '500px', width: 'auto' }} width="2848" height="1548" data-path="images/communication-preferences/overview.png" />
</Frame>

**الميزات الرئيسية**

* **تصاميم بريد إلكتروني معاد تصميمها**: قوالب بريد إلكتروني حديثة مع دعوات واضحة لاتخاذ إجراء وقابلية قراءة محسنة
* **إشعارات الدفع**: احصل على تنبيهات فورية على جهازك المحمول للأحداث الحرجة مثل المبيعات الجديدة والنزاعات والمدفوعات
* **ضوابط دقيقة**: اختر بالضبط الأحداث التي تُطلق الإشعارات ومن خلال أي قناة
* **دعم عدة عناوين بريد إلكتروني**: أضف عدة عناوين لتلقي الإشعارات
* **تفضيلات بريد إلكتروني للعملاء**: قم بتكوين الرسائل التي يتلقاها عملاؤك

**فئات الإشعارات**

| الفئة                           | الوصف                                                   |
| ------------------------------- | ------------------------------------------------------- |
| **المبيعات والمدفوعات**         | المبيعات الجديدة، المدفوعات الناجحة، المدفوعات الفاشلة  |
| **المدفوعات والمبالغ المستردة** | إكمال المدفوعات، طلبات الاسترداد، إتمام الاسترداد       |
| **الاشتراكات**                  | الاشتراكات الجديدة، التجديدات، الإلغاءات، تغييرات الخطة |
| **النزاعات**                    | فتح نزاع، ضرورة تقديم الأدلة، حل النزاع                 |

<Check>
  النتيجة: ابقَ مطلعاً على نشاط عملك مع إشعارات تصل بالطريقة والوقت الذين تختارهما.
</Check>

تعرف على المزيد: [دليل تفضيلات الاتصال](/features/communication-preferences)

### 2. **الحقول المخصصة في جلسات الدفع**

اجمع معلومات إضافية من العملاء أثناء الدفع باستخدام الحقول المخصصة. أضف حقول نصية، قوائم منسدلة، تواريخ، والمزيد للحصول على البيانات التي تحتاجها.

**أنواع الحقول المدعومة**

| النوع      | الوصف                         | حالة الاستخدام                          |
| ---------- | ----------------------------- | --------------------------------------- |
| `text`     | حقل نصي أحادي السطر           | اسم الشركة، ملاحظات الطلب               |
| `number`   | إدخال رقمي                    | الكمية، العمر                           |
| `email`    | إدخال بريد إلكتروني مع التحقق | بريد جهة الاتصال للفوترة                |
| `url`      | إدخال رابط مع التحقق          | الموقع الإلكتروني، الملف الاجتماعي      |
| `date`     | منتقي تاريخ                   | تاريخ التسليم، تاريخ الحدث              |
| `dropdown` | اختيار من خيارات محددة مسبقاً | الحجم، اللون، نوع الخطة                 |
| `boolean`  | خانة اختيار للقيم بنعم/لا     | الموافقة على الشروط، الاشتراك في النشرة |

**كيف يعمل**

```typescript theme={null}
const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'pdt_123', quantity: 1 }],
  custom_fields: [
    {
      key: 'company_name',
      label: 'Company Name',
      field_type: 'text',
      required: true
    },
    {
      key: 'team_size',
      label: 'Team Size',
      field_type: 'dropdown',
      options: ['1-10', '11-50', '51-200', '200+'],
      required: true
    },
    {
      key: 'newsletter',
      label: 'Subscribe to our newsletter',
      field_type: 'boolean',
      required: false
    }
  ],
  return_url: 'https://yoursite.com/success'
});
```

**الفوائد**

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

<Info>
  تُرجع قيم الحقول المخصّصة ضمن مصفوفة `custom_field_responses` في استجابات الدفع والاشتراك.
</Info>

تعرّف على المزيد: [الحقول المخصصة لجلسة الدفع](/developer-resources/checkout-session#15-collecting-custom-fields)

### 3. **توسيع دعم لغات صفحة الدفع**

تدعم صفحة الدفع الآن **21 لغة**، بدلاً من 16. استهدف المزيد من العملاء بلغتهم الأم لتحسين تجربة الدفع.

**اللغات الجديدة المضافة**

| اللغة       | الرمز |
| ----------- | ----- |
| الكورية     | `ko`  |
| الماليزية   | `ms`  |
| الرومانية   | `ro`  |
| الروسية     | `ru`  |
| التايلاندية | `th`  |

**جميع اللغات المدعومة**

العربية، الصينية، الهولندية، الإنجليزية، الفرنسية، الألمانية، الهندية، الإندونيسية، الإيطالية، اليابانية، الكورية، الماليزية، البرتغالية، الرومانية، الروسية، الإسبانية، السويدية، التايلاندية، التركية، الأوكرانية، الفيتنامية.

**فرض لغة معينة**

استخدم الوسيطة `force_language` لتجاوز الكشف التلقائي عن اللغة:

```typescript theme={null}
const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'pdt_123', quantity: 1 }],
  customization: {
    force_language: 'ko' // Force Korean language
  },
  return_url: 'https://yoursite.com/success'
});
```

<Tip>
  بشكل افتراضي، تكتشف صفحة الدفع لغة العميل المفضلة من إعدادات المتصفح. استخدم `force_language` عندما تريد ضمان التناسق مع لغة موقعك.
</Tip>

تعرف على المزيد: [دعم لغات صفحة الدفع](/features/checkout#supported-languages)

### 4. **إصلاحات عامة للأخطاء وتحسينات**

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