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.
الميزات الجديدة
1. أكواد الخصم المكدسة
جلسات الشراء والمدفوعات والاشتراكات وتغييرات الخطة تقبل الآن حتى 20 كود خصم في طلب واحد عبر مصفوفة discount_codes. يتم تطبيق الأكواد بترتيب المصفوفة — الكود الأول المؤهل يقلل السعر الأساسي، والثاني يقلل السعر المخفض بالفعل، وهكذا — بحيث يمكنك تكديس الحملات دون إنشاء أكواد مدمجة خاصة.
صور
const session = await client.checkoutSessions.create({
product_cart: [{ product_id: 'prod_abc', quantity: 1 }],
discount_codes: ['WELCOME10', 'BLACKFRIDAY20'], // applied in this order
customer: { email: 'user@example.com' },
return_url: 'https://yoursite.com/return'
});
| السطح | الحقل | الحد الأقصى للأكواد |
|---|
| جلسات الشراء | discount_codes | 20 |
| المدفوعات | discount_codes | 20 |
| الاشتراكات | discount_codes | 20 |
| تغييرات الخطة | discount_codes | 20 |
قيمة discount_codes | التأثير |
|---|
| لم يتم توفيرها | تبقى الخصومات الحالية مع preserve_on_plan_change=true إذا كانت قابلة للتطبيق على المنتج الجديد |
[] (مصفوفة فارغة) | تتم إزالة جميع الخصومات الحالية من الاشتراك |
['CODE_A', 'CODE_B', ...] | يحل محل أي خصومات حالية مع هذه المجموعة المكدسة، يتم تطبيقها بترتيب المصفوفة |
discounts في المدفوعات والاشتراكات — يتضمن كل إدخال discount_id وposition وcycles_remaining (للإشتراكات). الحقل الفردي القديم discount_id مهمل ولكنه موجود لضمان التوافق الخلفي.
صور
معرفة المزيد: أكواد الخصم | جلسة الشراء | تغييرات الخطة
2. سبعة رسائل بريد إلكتروني جديدة لإشعار العملاء
الآن يتم إرسال سبعة رسائل بريد إلكتروني جديدة للعملاء تلقائيًا، تغطي تأكيدات الاسترداد والمعالم في دورة حياة الاشتراك وفشل الدفع. يمكن تبديل كل بريد إلكتروني بشكل مستقل من الإعدادات → الاتصالات تحت قسم البريد الإلكتروني للعملاء.
صور
الاشتراك (ممكّن افتراضيًا)
| البريد الإلكتروني | متى يتم تفعيله |
|---|
| استرداد ناجح | يتم معالجة استرداد الأموال بنجاح وتكون الأموال في طريقها للعودة إلى العميل |
| انتهاء التجربة المجانية للاشتراك | ~2 أيام قبل انتهاء التجربة وبدء الشحنة الأولى للفواتير |
| إلغاء الاشتراك مباشرة | يتم إلغاء الاشتراك على الفور |
| تحديد إلغاء الاشتراك في تاريخ الشحنة التالي | يتم جدولة إلغاء الاشتراك في نهاية دورة الفواتير الحالية |
| البريد الإلكتروني | متى يتم تفعيله |
|---|
| فشل الدفع | فشل محاولة الدفع — تمكين إذا كنت ترغب في أن يقوم Dodo Payments بإخطار العميل مباشرة بدلاً من التعامل معها في النظام الخاص بك |
| فشل تجديد الاشتراك | فشل سداد تجديد اشتراك بشكل خاص؛ يتم تشغيله بدلاً من (وليس بالإضافة إلى) البريد الإلكتروني لفشل الدفع العام لمدفوعات التجديد |
| تذكير التجديد القادم | ~2 أيام قبل تجديد الاشتراك |
3. Sunbit — تمويل التقسيط للعملاء الأمريكيين
Sunbit متاح الآن كطريقة دفع للشراء الآن والدفع لاحقًا، مما يتيح للعملاء الأمريكيين تقسيم المشتريات إلى دفعات شهرية يمكن إدارتها عند التسجيل.
| الميزة | التفاصيل |
|---|
| التوافر | الولايات المتحدة |
| العملة | USD |
| المبلغ الأدنى | $60.00 |
| المبلغ الأقصى | $19,999.00 |
| الاشتراكات | غير مدعوم (مدفوعات مرة واحدة فقط) |
sunbit في allowed_payment_method_types لتمكينها في جلسة الشراء:
const session = await client.checkoutSessions.create({
product_cart: [{ product_id: 'prod_123', quantity: 1 }],
allowed_payment_method_types: ['sunbit', 'credit', 'debit'],
return_url: 'https://example.com/success'
});
التحسينات
4. إعادة تصميم صفحة دفع الشراء
تم إعادة تصميم صفحة الدفع عند الشراء بالكامل — تخطيط أكثر إحكامًا، تحميل أسرع، حالات تصديق أوضح، وتحسين تجربة استخدام إدخال البطاقة. بشكل عام، رفعت هذه التغييرات معدلات نجاح الشراء الملاحظة بنسبة ~2–3% عبر حركة المرور العالمية.
ما تم تغييره:
- تفاعل سلس بين الحقول — التركيز التلقائي، ترتيب التبويب الذكي، وتحسين التنقل عبر لوحة المفاتيح في نموذج البطاقة
- حالات خطأ وتحميل أنظف — تظهر المصادقة المضمنة بدقة حيث يجب على العميل التصرف، مما يستبدل نمط لافتة الخطأ الكامل النموذجي
- دهان أسرع — الهيكل العظمي والترطيب التقدمي يزيلان وميض الحالة الفارغة القصير على الشبكات البطيئة
- تحسين الطابع الشخصي للهواتف المحمولة — أهداف النقر، سلوك التمرير، ومعالجة لوحة المفاتيح معدلة خصيصًا للشراء على الهواتف المحمولة حيث يعيش غالبية حركة المرور الآن
صور
5. إعادة تصميم نموذج المنتج
تمت إعادة بناء تدفقات إنشاء وتحرير واستنساخ المنتج من الألف إلى الياء حول تجربة نموذج موحدة ومتسقة.
صور
الميزات البارزة:
- معاينة حية — شاهد كيف يظهر منتجك في الشراء وبوابة العميل أثناء التحرير، جنبًا إلى جنب مع النموذج
- الحفظ التلقائي — يتم حفظ المسودات تلقائيًا، لذلك لم يعد يعني التنقل بعيدًا أو فقدان التبويب فقدان عملك
- محرر Markdown — الآن تدعم وصفات المنتج محرر Markdown كامل مع عرض فوري الروابط ومراقبة التنسيق المضمنة
- التكافؤ في تدفق الاستنساخ — فتح استنساخ منتج في نفس النموذج الموحد المملوء مسبقًا، بدلاً من حوار مخفض، لذلك يمكنك تعديل كل حقل قبل حفظ النسخة
صور
6. إعادة تصميم صفحة إعدادات العمل
تم إعادة تصميم صفحة الإعدادات → الأعمال لتسهيل مسح التكوين وتحديثه بشكل أسرع. يتم الآن تجميع الإعدادات في أقسام أوضح مع نسخ توضيحية تصف تأثير كل مفتاح قبل قلبه.
لا توجد تغييرات سلوكية في الإعدادات الحالية — فقط تم تحسين التصميم والتجميع والشرح المحيط.
صور
التحسينات
- تم الآن نشر تجاوز
credits_amount بشكل صحيح إلى مسارات جلسة الشراء ورابط الدفع GET — عندما تم إنشاء جلسة شراء أو رابط دفع بتجاوز credit_entitlements لكل عملية شراء، كانت استعادة تلك الجلسة أو الرابط عبر GET تُرجع عادة credits_amount الافتراضية على مستوى المنتج بدلاً من القيمة المستثناة. هذا الآن تم إصلاحه.
- تم تعطيل إجراء الاسترداد للمدفوعات المستردة بالكامل — تم تعطيل زر الاسترداد على الدفع عند استرداد الدفعة بالكامل، مع توضيح السبب في تلميح. سابقاً كان الزر يبقى نشطًا ويعيد خطأً فقط بعد الإرسال.
- إصلاحات الأخطاء الصغيرة وتحسينات الاستقرار عبر المنصة
