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

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. الدفع المدمج - تجارب دفع مدمجة بالكامل (بيتا) قم بتضمين عملية دفع 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() للتحكم في الدفع برمجيًا
   النتيجة: تجارب دفع مدمجة بالكامل تتماشى مع علامتك التجارية وتوفر أقصى قدر من التحكم في سير الدفع.
   استخدم الدفع المضمن عندما تريد السيطرة القصوى على تصميم صفحة الدفع. استخدم overlay checkout للتكامل الأسرع مع أقل قدر من التعديلات على الصفحات الحالية.
   لمعرفة المزيد: دليل الدفع المدمج
2. إنشاء المدفوعات والاشتراكات وتجارب الدفع باستخدام طرق الدفع الحالية
   قم بتبسيط تدفقات الدفع باستخدام طرق الدفع المحفوظة من العملاء الحاليين. يسمح لك المعامل الجديد payment_method_id بإنشاء مدفوعات أو اشتراكات أو جلسات دفع باستخدام طريقة الدفع المحفوظة سابقًا للعميل.

   ​

   الفوائد

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

   ​

   كيف يعمل

   استخدم payment_method_id عند إنشاء جلسات الدفع أو المدفوعات أو الاشتراكات:
   • Checkout Sessions
   • One-Time Payments
   • Subscriptions

   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 للتعديلات الشائعة على الاشتراكات.
   استخدم لوحة التحكم لتغيير خطط الاشتراك بسرعة، واعتمد على واجهة برمجة التطبيقات لإدارة الاشتراكات برمجيًا في تطبيقك.
4. روابط قصيرة لروابط الدفع
   إنشاء روابط دفع أنظف وأسهل للمشاركة مع ميزة الروابط القصيرة الجديدة لدينا. توفر الروابط القصيرة عناوين URL للدفع مختصرة مع شفرات مخصصة، مما يجعلها أسهل للمشاركة مع العملاء أو تضمينها في موقعك.
   

   ​

   الفوائد

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

   ​

   كيف يعمل

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

   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'
   });
   
   النتيجة: رابط دفع مختصر يسهل مشاركته ويبدو أكثر احترافية، مما يُحسّن معدلات التحويل وثقة العملاء.
   يتم إدارة الروابط القصيرة في لوحة التحكم ويمكنك عرضها عبر List Short Links API.
5. redirect_immediately Flag - Skip Payment Success Page
   تحكم في سير الدفع باستخدام العلم الجديد redirect_immediately. عند تفعيله، يتم إعادة توجيه العملاء فور اكتمال الدفع، متجاوزين صفحة النجاح الافتراضية لتجربة أسرع وأكثر انسيابية.

   ​

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

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

   ​

   كيف يعمل

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

const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'prod_123', quantity: 1 }],
  feature_flags: {
    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'
});

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. إصلاحات عامة وتحسينات
   تتضمن هذه النسخة تحسينات في الأداء، وتلميع واجهة المستخدم، وحل الأخطاء الطفيفة لتجربة أكثر موثوقية وسلاسة.