
دفع دودو هو صفحة دفع مصممة لتعظيم التحويل والامتثال العالمي موجهة للمنتجات الرقمية وشركات SaaS. تدعم عملات ولغات وضرائب وخصومات وإضافات متعددة، بالإضافة إلى سير عمل امتثال مناسب للأعمال.
Checkout Sessions API
قم بإنشاء جلسات دفع مستضافة برمجياً.
Preview Checkout
احتسب التسعير والضرائب قبل إنشاء الجلسة.
Payment Methods
طرق الدفع المدعومة وخيارات التكوين.
روابط Checkout التي يتم إنشاؤها عبر Checkout Sessions API غير قابلة لإعادة الاستخدام وتنتهي صلاحيتها خلال 24 ساعة. أنشئ جلسة جديدة لكل عميل ولكل محاولة دفع.
Adaptive Currency
تتيح Adaptive Currency للعملاء الدفع بعملتهم المحلية المفضلة، مما يعزز الثقة ومعدلات التحويل.آلية العمل
- التفعيل: فعّل Adaptive Currency من Settings → Business
- الاختيار: يمكن للعملاء تبديل العملات مباشرةً في صفحة الدفع
- التحويل: تُحوَّل الأسعار ديناميكيًا باستخدام أسعار صرف العملات الأجنبية الآنية
- العرض: يُعرض المبلغ النهائي المستحق بوضوح قبل الدفع

Adaptive Currency
تعرّف على المزيد حول العملات المدعومة ورسوم التحويل ومعالجة المبالغ المستردة.
Checkout متعدد اللغات
يدعم Dodo Payments لغات متعددة في صفحة الدفع، مما يتيح للعملاء إتمام عمليات الدفع باللغة التي يشعرون بالراحة عند استخدامها.
أبرز المزايا
- يتوفر محدد اللغة مباشرةً في صفحة الدفع
- تتم ترجمة نصوص واجهة المستخدم والتسميات ورسائل النظام
- يحسن إمكانية الوصول والتحويلات الدولية
اللغات المدعومة
تدعم صفحة الدفع 21 لغة:حساب الضرائب تلقائيًا
تُحسب الضرائب تلقائيًا استنادًا إلى موقع فوترة العميل، مما يضمن الامتثال لمتطلبات GST وVAT وضريبة المبيعات دون إعداد يدوي.آلية حساب الضرائب
1
Location Detection
تُطبَّق القواعد الضريبية استنادًا إلى بلد العميل (والمنطقة عند الاقتضاء).
2
Dynamic Updates
يُحدَّث مبلغ الضريبة تلقائيًا عند:
- تغيير البلد
- تحديث العنوان
3
Transparent Display
يُعرض التفصيل النهائي للضريبة بوضوح قبل الدفع.
دعم Tax ID للأعمال
بالنسبة إلى الأنشطة التجارية المسجلة، تتيح صفحة الدفع للعملاء إدخال Business Tax ID الخاص بهم (مثل رقم VAT/GST).ما يحدث عند إدخال Tax ID
- يتم التحقق من الأهلية الضريبية في الوقت الفعلي
- تُطبَّق الإعفاءات الضريبية أو قواعد الاحتساب العكسي السارية
- يُحدَّث مبلغ الضريبة فورًا في صفحة الدفع

يفيد ذلك بشكل خاص في خدمات B2B SaaS والخدمات الرقمية التي قد تكون فيها الأنشطة التجارية مؤهلة للحصول على إعفاءات ضريبية.
رموز الخصم
يمكن للعملاء تطبيق رموز الخصم أو الرموز الترويجية التي أنشأتها في لوحة التحكم مباشرةً في صفحة الدفع.تجربة الدفع
- يُدخل العميل رمز الخصم
- يتم التحقق من الرمز فورًا
- يُعرض السعر المحدّث ومقدار التوفير بوضوح

تكامل API
طبّق مسبقًا رمز خصم واحدًا أو أكثر من رموز الخصم المتراكمة، أو فعّل حقل إدخال الخصم:يقبل
discount_codes مصفوفةً تضم ما يصل إلى 20 رمزًا تُطبَّق بالتسلسل. حقل discount_code المفرد مهجور، لكنه لا يزال يعمل — ولا تحتاج عمليات التكامل الحالية إلى التغيير فورًا. انتقل إلى discount_codes عندما يناسبك للاستفادة من التراكم وبنية الاستجابة الأكثر شمولًا.Discount Codes
تعرّف على كيفية إنشاء رموز الخصم وإدارتها.
Validate Discount by Code
ابحث عن الخصومات وتحقق منها باستخدام أسماء الرموز.
جمع العناوين الذكي
تدعم صفحة الدفع إدخال العنوان بمرونة لإتمام العملية بسرعة أكبر.الخيارات المتاحة
وضع العنوان المختصر
لتحقيق أعلى معدل تحويل، فعّل جمع العنوان المختصر لتقليل العوائق أثناء الدفع. عند ضبطminimal_address على true، تجمع صفحة الدفع ما يلي فقط:
- البلد — مطلوب دائمًا لتحديد الضرائب
- الرمز البريدي — في المناطق التي يلزم فيها لحساب ضريبة المبيعات أو VAT أو GST فقط

يظل جمع العنوان الكامل هو الإعداد الافتراضي. فعّل
minimal_address للمنتجات الرقمية وتدفقات SaaS التي لا تتطلب تفاصيل فوترة كاملة.Minimal Address Reference
راجع المرجع الكامل لمعامل
minimal_address في دليل Checkout Sessions API.جمع أرقام الهواتف
تحكم في ظهور حقل رقم الهاتف في صفحة الدفع — وما إذا كان مطلوبًا — باستخدام أعلام ميزات جلسة Checkout.الحقول المخصصة
اجمع معلومات إضافية من العملاء أثناء الدفع من خلال تعريف حقول نموذج مخصصة. يفيد ذلك في جمع بيانات مثل اسم الشركة وحجم الفريق ومصدر الإحالة أو أي معلومات أخرى خاصة بالعمل.أنواع الحقول المتاحة
مثال
تُضمَّن إجابات العملاء تلقائيًا في حمولات webhook (
payment.succeeded وsubscription.active) وفي استجابات API عبر مصفوفة custom_field_responses. يمكنك تعريف ما يصل إلى 5 حقول مخصصة لكل جلسة Checkout.Custom Fields Guide
تعرّف على المزيد حول إعداد الحقول المخصصة والوصول إلى الإجابات.
قبول سياسة الخصوصية والشروط
لضمان الشفافية القانونية والامتثال:- يتم عرض رابطَي Privacy Policy وBuyer Terms بوضوح في صفحة الدفع
- يقرّ العملاء بهذين المستندين صراحةً قبل إتمام الدفع
يساعد ذلك على تلبية متطلبات حماية المستهلك وخصوصية البيانات عالميًا، بما في ذلك الامتثال لـ GDPR.
الدفع عبر مجموعة المنتجات
تتيح Product Collections تجربة دفع موحدة يمكن للعملاء من خلالها عرض منتجات متعددة ذات صلة واختيارها (مثل خطط Starter وPro وEnterprise) في عملية دفع واحدة.آلية العمل
- عرض جميع المنتجات: يرى العملاء كل منتج نشط في المجموعة
- تحديد المنتج الأول مسبقًا: يتم تحديد المنتج الأول في المجموعة تلقائيًا
- مقارنة الخيارات: يمكن للعملاء مقارنة الأسعار والمزايا قبل الاختيار
- اختيار واحد: بعد اختيار المنتج، تستمر عملية الدفع باستخدام التدفق القياسي للدفع
إنشاء عملية دفع لمجموعة
Product Collections
تعرّف على كيفية إنشاء مجموعات المنتجات وإدارتها لتوفير تجارب دفع موحدة.
إعداد Checkout Session
تحكم في سلوك صفحة الدفع باستخدام Checkout Sessions API:بعد الدفع، يُعاد توجيه العملاء إلى
return_url الخاص بك، مع إلحاق معاملات query تلقائيًا — بما في ذلك payment_id أو subscription_id وstatus وemail وlicense_key (عند الاقتضاء). راجع دليل Checkout Sessions للحصول على القائمة الكاملة.Checkout Sessions API
مرجع API الكامل لجلسات Checkout.
Checkout Integration Guide
دليل تفصيلي خطوة بخطوة لدمج صفحة الدفع.
تخصيص مظهر صفحة الدفع
خصّص مظهر صفحة الدفع ليتوافق مع علامتك التجارية باستخدام معاملcustomization.theme_config عند إنشاء جلسة Checkout عبر API. اضبط الألوان والخطوط ونصف قطر الحدود ونص الزر لكل من الوضعين الفاتح والداكن.

Design & Theme Customization
اضبط المظاهر بصريًا من لوحة التحكم باستخدام مظاهر مُعدة مسبقًا، وطباعة، وألوان، ومعاينة مباشرة.
يغطي هذا القسم إعداد المظهر عبر server-side API باستخدام
customization.theme_config. إذا كنت تستخدم Checkout SDK (الدفع عبر overlay أو inline)، فراجع قسم تخصيص المظهر في Overlay Checkout، الذي يستخدم خصائص camelCase (مثل bgPrimary بدلًا من bg_primary).خيارات إعداد المظهر
إعداد الألوان (الوضع الفاتح/الداكن)
يدعم كل وضع (light وdark) خصائص الألوان التالية:
تقبل جميع حقول الألوان تنسيقات ألوان CSS القياسية:
- Hex:
#fffو#ffffffو#ffffffff - RGB/RGBA:
rgb(255, 255, 255)وrgba(255, 255, 255, 0.5) - HSL/HSLA:
hsl(120, 100%, 50%)وhsla(120, 100%, 50%, 0.5) - الألوان المسماة:
redوblueوtransparent