
دفع دودو هو صفحة دفع مصممة لتعظيم التحويل والامتثال العالمي موجهة للمنتجات الرقمية وشركات SaaS. تدعم عملات ولغات وضرائب وخصومات وإضافات متعددة، بالإضافة إلى سير عمل امتثال مناسب للأعمال.
Checkout Sessions API
قم بإنشاء جلسات دفع مستضافة برمجياً.
Preview Checkout
احتسب التسعير والضرائب قبل إنشاء الجلسة.
Payment Methods
طرق الدفع المدعومة وخيارات التكوين.
روابط Checkout التي يتم إنشاؤها عبر Checkout Sessions API غير قابلة لإعادة الاستخدام وتنتهي صلاحيتها خلال 24 ساعة. أنشئ جلسة جديدة لكل عميل ولكل محاولة دفع.
Adaptive Currency
تتيح Adaptive Currency للعملاء الدفع بعملتهم المحلية المفضلة، مما يعزز الثقة ومعدلات التحويل.آلية العمل
- التفعيل: فعّل Adaptive Currency من الإعدادات ← النشاط التجاري
- التحديد: يمكن للعملاء تبديل العملات مباشرةً في صفحة الدفع
- تطبيق PPP: إذا كان Purchasing Power Parity مفعّلًا للمنتج، فإن نسبة البلد تخفّض السعر الأساسي
- التحويل: يُحوَّل السعر (أو السعر المعدّل وفق PPP) إلى عملة العميل باستخدام أسعار الصرف الأجنبي المباشرة
- التقريب: إذا كان Charm Pricing مفعّلًا، يُقرَّب المبلغ المحوَّل إلى نهاية سعر واضحة مثل 49.99
- العرض: يُعرض المبلغ النهائي المستحق الدفع بشفافية قبل الدفع

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