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

Adaptive Currency
تعرف على المزيد حول العملات المدعومة ورسوم التحويل والتعامل مع الاسترداد.
الدفع متعدد اللغات
تدعم مدفوعات دودي لغات متعددة في صفحة الدفع، مما يسمح للعملاء بإكمال المدفوعات بلغة يشعرون بالراحة بها.
النقاط الرئيسية
- محدد اللغة متاح مباشرة عند الدفع
- النصوص، والعناوين، ورسائل النظام محلية
- يحسن الوصول والتحويل الدولي
اللغات المدعومة
تدعم صفحة الدفع 21 لغة:| اللغة | الرمز |
|---|---|
| العربية | ar |
| الكاتالونية | ca |
| الصينية | zh |
| الهولندية | nl |
| الإنجليزية | en |
| الفرنسية | fr |
| الألمانية | de |
| العبرية | he |
| الإندونيسية | id |
| الإيطالية | it |
| اليابانية | ja |
| الكورية | ko |
| الملايو | ms |
| البولندية | pl |
| البرتغالية | pt |
| الرومانية | ro |
| الروسية | ru |
| الإسبانية | es |
| السويدية | sv |
| التايلاندية | th |
| التركية | tr |
حساب الضرائب التلقائي
يتم حساب الضرائب تلقائياً بناءً على موقع دفع العميل، مما يضمن الامتثال لمتطلبات GST وVAT وضريبة المبيعات دون إعداد يدوي.كيف يعمل حساب الضرائب
دعم رقم تعريف الضريبة للأعمال
بالنسبة للأعمال المسجلة، تتيح صفحة الدفع للعملاء إدخال رقم تعريف ضريبة العمل (مثل رقم VAT/GST).ماذا يحدث عند إدخال رقم الضريبة
- يتم التحقق من الأهلية الضريبية في الوقت الفعلي
- تُطبق الإعفاءات الضريبية المعمول بها أو قواعد الضريبة المعكوسة
- يتم تحديث مبلغ الضريبة فوراً على صفحة الدفع

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

تكامل API
تطبيق مسبقًا لرمز خصم واحد أو أكثر أو تفعيل حقل إدخال الخصم:discount_codes يستقبل مجموعة تصل إلى 20 رمزًا مكدسًا بالترتيب. الحقل الفردي discount_code تم إهماله لكنه لا يزال يعمل — ليس من الضروري تغيير التكاملات الحالية على الفور. انتقل إلى discount_codes عند التمكن من استخدام التكديس والشكل الأغنى للاستجابة.Discount Codes
تعلّم كيفية إنشاء وإدارة رموز الخصم.
Validate Discount by Code
ابحث وتحّقق من الخصومات باستخدام أسماء الرموز.
جمع العناوين الذكية
يدعم الدفع إدخال العناوين بمرونة لإكمالها بشكل أسرع.الخيارات المتاحة
| الخيار | الوصف |
|---|---|
| الملء التلقائي لعناوين Google | اختيار سريع مع الإكمال التلقائي |
| الإدخال اليدوي | التحكم الكامل في العناوين الكاملة |
| اختيار الدولة | يحرك منطق الضرائب والامتثال |
جمع أرقام الهاتف
تحكم فيما إذا كان حقل رقم الهاتف يظهر في صفحة الدفع — وما إذا كان مطلوبًا — باستخدام أعلام ميزة جلسة الدفع.| العلم | الافتراضي | السلوك |
|---|---|---|
allow_phone_number_collection | true | يظهر حقل رقم الهاتف على نموذج الدفع |
require_phone_number | false | يجعل حقل رقم الهاتف مطلوبًا (التحقق من صحة النموذج يفرض وجود قيمة غير فارغة) |
الحقول المخصصة
جمع معلومات إضافية من العملاء أثناء الدفع عن طريق تحديد حقول النموذج المخصصة. هذا مفيد لجمع بيانات مثل اسم الشركة، حجم الفريق، مصدر الإحالة، أو أي معلومات أخرى خاصة بالعمل.أنواع الحقول المتاحة
| النوع | الوصف |
|---|---|
text | إدخال نصي بخط واحد |
number | إدخال رقمي |
email | عنوان بريد إلكتروني مع التحقق |
url | URL مع التحقق |
date | منتقي التاريخ |
dropdown | اختيار من خيارات محددة مسبقًا |
boolean | تبديل نعم/لا |
مثال
يتم تضمين ردود العملاء تلقائيًا في حمولات webhook (
payment.succeeded, subscription.active) واستجابات API عبر المصفوفة custom_field_responses. يمكنك تحديد ما يصل إلى 5 حقول مخصصة لكل جلسة دفع.Custom Fields Guide
تعرّف على المزيد حول تكوين الحقول المخصصة والوصول إلى الردود.
سياسة الخصوصية و قبول الشروط
لضمان شفافية الامتثال القانوني:- روابط سياسة الخصوصية وشروط المشتري واضحة على صفحة الدفع
- يعترف العملاء بهذه الصراحة قبل إكمال الدفع
يساعد هذا في تلبية متطلبات حماية المستهلك العالمية ومتطلبات خصوصية البيانات بما في ذلك التوافق مع GDPR.
دفع التجميع
تمكّن مجموعات المنتجات من تجربة دفع موحدة حيث يمكن للعملاء عرض واختيار من بين منتجات متعددة ذات صلة (مثل خطط Starter وPro وEnterprise) في دفع واحد.كيف تعمل
- عرض جميع المنتجات: يشاهد العملاء كل منتج نشط في المجموعة
- تم اختيار المنتج الأول مسبقًا: يتم اختيار المنتج الأول في المجموعة تلقائيًا
- مقارنة الخيارات: يمكن للعملاء مقارنة الأسعار والميزات قبل الاختيار
- اختيار واحد: بعد اختيار المنتج، يتم المتابعة بالدفع بالطريقة القياسية
إنشاء دفع مجموعات
Product Collections
تعرّف على كيفية إنشاء وإدارة مجموعات المنتجات لتجارب دفع موحدة.
تكوين جلسة الدفع
تحكم في سلوك الدفع باستخدام API لجلسات الدفع:بعد الدفع، يتم إعادة توجيه العملاء إلى
return_url الخاص بك مع إلحاق معلمات الاستعلام تلقائيًا — بما في ذلك payment_id أو subscription_id, status, email, وlicense_key (إذا كان ذلك تطبيقيًا). انظر إلى دليل جلسات الدفع للحصول على القائمة الكاملة.Checkout Sessions API
مرجع API كامل لجلسات الدفع.
Checkout Integration Guide
دليل خطوة بخطوة لتكامل الدفع.
تخصيص مظهر الدفع
خصص مظهر صفحة الدفع لتتناسب مع علامتك التجارية باستخدامcustomization.theme_config عند إنشاء جلسة دفع عبر API. قم بتكوين الألوان والخطوط ونصف قطر الحدود والنص لزر الدفع في وضعي النهار والليل.

Design & Theme Customization
قم بتكوين المواضيع بصريًا من لوحة التحكم باستخدام المواضيع المدمجة، والكتابة، والألوان، والمعاينة الحية.
تغطي هذه الجزء تكوين موضوع API الجانب الخادم باستخدام
customization.theme_config. إذا كنت تستخدم SDK الدفع (الدفع عبر التراكب أو الدفع المضمن)، انظر إلى أقسام تخصيص الموضوعات في الدفع عبر التراكب أو الدفع المضمن التي تستخدم خصائص camelCase (مثلاً، bgPrimary بدلاً من bg_primary).خيارات تكوين المواضيع
| الخاصية | الوصف |
|---|---|
light | تكوين الألوان لوضع النهار |
dark | تكوين الألوان لوضع الليل |
font_primary_url | رابط للخط الأساسي |
font_secondary_url | رابط للخط الثانوي |
font_size | حجم الخط: xs, sm, md, lg, xl, 2xl |
font_weight | وزن الخط: normal, medium, bold, extraBold |
radius | نصف قطر الحدود لعناصر واجهة المستخدم (مثل 4px, 0.5rem, 8px) |
pay_button_text | نص مخصص لزر الدفع (مثل “إكمال الشراء”, “اشترك الآن”) |
تكوين الألوان (وضع النهار/الليل)
يدعم كل وضع (light وdark) الخصائص اللونية التالية:
| الخاصية | الوصف |
|---|---|
bg_primary | لون الخلفية الأساسي |
bg_secondary | لون الخلفية الثانوي |
text_primary | لون النص الأساسي |
text_secondary | لون النص الثانوي |
text_placeholder | لون نص العنصر النائب |
text_error | لون نص الخطأ |
text_success | لون نص النجاح |
border_primary | لون الحدود الأساسي |
border_secondary | لون الحدود الثانوي |
button_primary | لون خلفية الزر الأساسي |
button_primary_hover | لون تحويم الزر الأساسي |
button_secondary | لون خلفية الزر الثانوي |
button_secondary_hover | لون تحويم الزر الثانوي |
button_text_primary | لون نص الزر الأساسي |
button_text_secondary | لون نص الزر الثانوي |
input_focus_border | لون حدود تركيز الإدخال |
تقبل جميع الحقول اللونية تنسيقات ألوان 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