v1.70.0 (24 ديسمبر 2025)

​

ميزات جديدة 🚀

1. الدفع المدمج - تجارب دفع مدمجة بالكامل (بيتا) قم بتضمين عملية دفع Dodo Payments مباشرة في موقعك للحصول على تجربة دفع سلسة ومميزة. على عكس الدفع المنبثق الذي يفتح كنافذة منبثقة، يقوم الدفع المدمج بتضمين نموذج الدفع مباشرة في تخطيط صفحتك.
   

   ​

   الفوائد

   • مدمج بالكامل: إنشاء تجارب دفع تتماشى بسلاسة مع موقعك
   • ملخصات الطلب المخصصة: بناء واجهة مستخدم مخصصة تتزامن مع الدفع في الوقت الحقيقي
   • أقصى تحكم: تحكم كامل في تخطيط وتصميم الدفع
   • متوافق مع PCI: تتعامل Dodo Payments بأمان مع جميع معلومات الدفع الحساسة
   • تزامن في الوقت الحقيقي: استخدم أحداث SDK للحفاظ على تزامن واجهة المستخدم مع حالة الدفع

   ​

   كيف يعمل

   قم بتهيئة SDK باستخدام displayType: 'inline' وادمج الدفع في عنصر حاوية:
   نسخ

   اسأل الذكاء الاصطناعي

   import { DodoPayments } from "dodopayments-checkout";
   
   // Initialize the SDK for inline mode
   DodoPayments.Initialize({
     mode: "test",
     displayType: "inline",
     onEvent: (event) => {
       if (event.event_type === "checkout.breakdown") {
         // Update your UI with real-time tax and total calculations
         const breakdown = event.data?.message;
       }
     },
   });
   
   // Open checkout in a specific container
   DodoPayments.Checkout.open({
     checkoutUrl: "https://test.dodopayments.com/session/cks_123",
     elementId: "dodo-inline-checkout" // ID of the container element
   });
   

   ​

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

   • أحداث تفصيلية في الوقت الحقيقي: استقبل checkout.breakdown الأحداث عند إدخال العملاء لتفاصيلهم
   • ملخصات الطلب المخصصة: بناء عرض تسعير خاص بك يتحدث في الوقت الحقيقي
   • تكامل سلس: إطار الدفع يتعامل مع جمع المدفوعات بينما تتحكم في التخطيط
   • طرق SDK: استخدم open()، close()، و isOpen() للتحكم في الدفع برمجياً
   النتيجة: تجارب دفع مدمجة بالكامل تتناسب مع علامتك التجارية وتوفر أقصى تحكم في تدفق الدفع.
   استخدم الدفع المدمج عندما تريد أقصى تحكم في تصميم الدفع. استخدم الدفع المنبثق للتكامل الأسرع مع تغييرات طفيفة في الصفحات الحالية.
   لمعرفة المزيد: دليل الدفع المدمج
2. إنشاء المدفوعات، الاشتراكات، والدفع باستخدام طرق الدفع الحالية
   قم بتبسيط تدفقات الدفع باستخدام طرق الدفع المحفوظة من العملاء الحاليين. يسمح لك المعامل payment_method_id بإنشاء المدفوعات، الاشتراكات، أو جلسات الدفع باستخدام طريقة الدفع المحفوظة مسبقًا للعميل.

   ​

   الفوائد

   • دفع أسرع: تخطي جمع طريقة الدفع للعملاء العائدين
   • مشتريات بنقرة واحدة: تمكين المشتريات الفورية باستخدام طرق الدفع المحفوظة
   • إدارة الاشتراكات: إنشاء الاشتراكات بسهولة باستخدام طرق الدفع الحالية
   • تحسين التحويل: تقليل الاحتكاك في الدفع للعملاء المتكررين

   ​

   كيف يعمل

   استخدم payment_method_id عند إنشاء جلسات الدفع، المدفوعات، أو الاشتراكات:
   • جلسات الدفع
   • مدفوعات لمرة واحدة
   • الاشتراكات

   نسخ

   اسأل الذكاء الاصطناعي

   const session = await client.checkoutSessions.create({
     product_cart: [{ product_id: 'prod_123', quantity: 1 }],
     customer: {
       customer_id: 'cus_123'
     },
     payment_method_id: 'pm_abc123',
     confirm: true
   });
   

   نسخ

   اسأل الذكاء الاصطناعي

   const payment = await client.payments.create({
     product_cart: [{ product_id: 'prod_123', quantity: 1 }],
     customer_id: 'cus_123',
     payment_method_id: 'pm_abc123'
   });
   

   نسخ

   اسأل الذكاء الاصطناعي

   const subscription = await client.subscriptions.create({
     customer_id: 'cus_123',
     product_id: 'prod_subscription',
     payment_method_id: 'pm_abc123'
   });
   
   عند استخدام payment_method_id في جلسات الدفع، يجب تعيين confirm إلى true، ويجب تقديم customer_id موجود. سيتم التحقق من صحة طريقة الدفع من حيث الأهلية مع عملة الدفع.
   يجب أن تنتمي طريقة الدفع إلى العميل وأن تكون متوافقة مع عملة الدفع. إذا فشلت عملية التحقق، ستعيد الطلب خطأ.
3. تغييرات خطة الاشتراك في لوحة التحكم مع تحديثات تاريخ الفوترة التالي إدارة خطط الاشتراك مباشرة من لوحة التحكم مع تحكم معزز. يمكنك الآن تغيير خطط الاشتراك وتحديث تاريخ الفوترة التالي في إجراء واحد، مما يمنحك مرونة كاملة في إدارة الاشتراكات.
   

   ​

   ميزات لوحة التحكم

   • تغييرات الخطة: ترقية أو تخفيض الاشتراكات بنقرة واحدة
   • تحكم في تاريخ الفوترة: تحديث تاريخ الفوترة التالي عند تغيير الخطط
   • خيارات التناسب: اختر كيفية التعامل مع التناسب عند تغيير الخطط
   • معاينة بصرية: رؤية بالضبط كيف تؤثر تغييرات الخطة على الفوترة قبل التأكيد

   ​

   حالات الاستخدام

   • دعم العملاء: ضبط خطط الاشتراك بسرعة لطلبات العملاء
   • ترقيات ترويجية: ترقية مؤقتة للعملاء مع تواريخ فوترة محددة
   • انتقالات الخطط: الانتقال بسلاسة بين مستويات الاشتراك للعملاء
   • محاذاة الفوترة: محاذاة تواريخ الفوترة عبر اشتراكات متعددة
   النتيجة: تحكم كامل في إدارة الاشتراكات من لوحة التحكم، مما يقلل الحاجة إلى استدعاءات API للتعديلات الشائعة على الاشتراكات.
   استخدم لوحة التحكم لتغييرات سريعة في خطة الاشتراك، وAPI لإدارة الاشتراكات برمجياً في تطبيقك.
4. روابط قصيرة لروابط الدفع
   إنشاء روابط دفع أنظف وأسهل للمشاركة مع ميزة الروابط القصيرة الجديدة لدينا. توفر الروابط القصيرة عناوين URL للدفع مختصرة مع شفرات مخصصة، مما يجعلها أسهل للمشاركة مع العملاء أو تضمينها في موقعك.
   

   ​

   الفوائد

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

   ​

   كيف يعمل

   قم بتمكين الروابط القصيرة عند إنشاء جلسات الدفع أو روابط الدفع:
   • جلسات الدفع
   • روابط الدفع

   نسخ

   اسأل الذكاء الاصطناعي

   const session = await client.checkoutSessions.create({
     product_cart: [{ product_id: 'prod_123', quantity: 1 }],
     short_link: true,
     return_url: 'https://yourapp.com/success'
   });
   

   نسخ

   اسأل الذكاء الاصطناعي

   const payment = await client.payments.create({
     product_cart: [{ product_id: 'prod_123', quantity: 1 }],
     short_link: true,
     return_url: 'https://yourapp.com/success'
   });
   
   النتيجة: رابط دفع مختصر يسهل مشاركته ويبدو أكثر احترافية، مما يحسن معدلات التحويل وثقة العملاء.
   يتم إدارة الروابط القصيرة في لوحة التحكم الخاصة بك ويمكن عرضها عبر API قائمة الروابط القصيرة.
5. redirect_immediately علم - تخطي صفحة نجاح الدفع
   تحكم في تدفق الدفع باستخدام العلم الجديد redirect_immediately. عند تمكينه، يتم إعادة توجيه العملاء مباشرة بعد إتمام الدفع، متجاوزين صفحة النجاح الافتراضية لتجربة أسرع وأكثر سلاسة.

   ​

   حالات الاستخدام

   • تدفق دفع أسرع: تقليل الاحتكاك عن طريق تخطي الصفحات الوسيطة
   • صفحات نجاح مخصصة: إعادة التوجيه مباشرة إلى صفحة النجاح الخاصة بك
   • تحسين الهاتف المحمول: تحسين تجربة الدفع على الهاتف المحمول مع إعادة التوجيه الفوري
   • الدفع المدمج: التكامل بسلاسة مع تدفقات الدفع المنبثقة أو المدمجة

   ​

   كيف يعمل

   قم بتمكين إعادة التوجيه الفوري في جلسات الدفع، المدفوعات، أو الاشتراكات:
   • جلسات الدفع
   • مدفوعات لمرة واحدة
   • الاشتراكات

   نسخ

   اسأل الذكاء الاصطناعي

   const session = await client.checkoutSessions.create({
     product_cart: [{ product_id: 'prod_123', quantity: 1 }],
     redirect_immediately: true,
     return_url: 'https://yourapp.com/success'
   });
   

   نسخ

   اسأل الذكاء الاصطناعي

   const payment = await client.payments.create({
     product_cart: [{ product_id: 'prod_123', quantity: 1 }],
     redirect_immediately: true,
     return_url: 'https://yourapp.com/success'
   });
   

   نسخ

   اسأل الذكاء الاصطناعي

   const subscription = await client.subscriptions.create({
     customer_id: 'cus_123',
     product_id: 'prod_subscription',
     redirect_immediately: true,
     return_url: 'https://yourapp.com/success'
   });
   
   استخدم redirect_immediately: true عندما يكون لديك صفحة نجاح مخصصة توفر تجربة مستخدم أفضل من صفحة نجاح الدفع الافتراضية.
   عند تمكين redirect_immediately، يتم إعادة توجيه العملاء إلى return_url مباشرة بعد إتمام الدفع، متجاوزين صفحة النجاح الافتراضية تمامًا.
6. الاشتراكات عند الطلب - متاحة لجميع الأعمال
   تم تمكين الاشتراكات عند الطلب الآن لجميع الأعمال، مما يمنحك تحكمًا مرنًا في الفوترة للخدمات المعتمدة على الاستخدام والمقاسة.

   ​

   ما الذي يتيحه هذا

   • فوترة معتمدة على الاستخدام: إنشاء اشتراكات وفرض رسوم على العملاء بناءً على الاستخدام الفعلي
   • دورات فوترة مرنة: فرض رسوم على العملاء عند الطلب بدلاً من الفترات الثابتة
   • خدمات مقاسة: مثالية لاستخدام API، التخزين، وقت الحوسبة، والموارد المقاسة الأخرى
   • تحكم يدوي في الرسوم: إنشاء رسوم يدويًا عند الحاجة، مما يمنحك تحكمًا كاملًا في توقيت الفوترة

   ​

   كيف يعمل

   قم بإنشاء اشتراك عند الطلب وفرض رسوم على العملاء حسب الحاجة:
   نسخ

   اسأل الذكاء الاصطناعي

   // Create an on-demand subscription
   const subscription = await client.subscriptions.create({
     customer_id: 'cus_123',
     product_id: 'prod_api_access',
     on_demand: true
   });
   
   // Charge the customer when usage occurs
   await client.subscriptions.createCharge(subscription.id, {
     amount: 4900,
     currency: 'USD',
     description: 'API usage for September: 1,000 requests'
   });
   
   النتيجة: تحكم كامل في متى وكم يتم فرض رسوم على العملاء، مثالي لنماذج الأعمال المعتمدة على الاستخدام.
   لمعرفة المزيد: الاشتراكات عند الطلب
7. إصلاحات عامة وتحسينات
   تتضمن هذه النسخة تحسينات في الأداء، وتلميع واجهة المستخدم، وحل الأخطاء الطفيفة لتجربة أكثر موثوقية وسلاسة.