Skip to main content
صفحة الدفع
صفحة الدفع في Dodo Payments هي صفحة دفع مستضافة مصممة للمنتجات الرقمية وSaaS. تتولى تحويل العملات، وحساب الضرائب، ورموز الخصم، وجمع العناوين، واختيار طريقة الدفع. تنشئ جلسة دفع عبر API أو لوحة التحكم، ثم يُكمل العملاء الدفع في صفحة آمنة تحمل علامتك التجارية.

Checkout Sessions API

أنشئ جلسات الدفع برمجيًا.

Preview Checkout

احتسب التسعير والضرائب قبل إنشاء الجلسة.

Payment Methods

طرق الدفع المدعومة وإعداداتها.

Integration Guide

دليل تفصيلي خطوة بخطوة لدمج الدفع.
روابط الدفع التي يتم إنشاؤها عبر Checkout Sessions API غير قابلة لإعادة الاستخدام. تنتهي صلاحيتها بعد 24 ساعة، أو بعد 15 دقيقة إذا تم تعيين confirm: true. أنشئ جلسة جديدة لكل عميل ولكل محاولة دفع.

Adaptive Currency

تتيح Adaptive Currency للعملاء الدفع بعملتهم المحلية المفضلة، مما يحسّن الثقة ومعدلات التحويل. عند تفعيلها، يرى العملاء محددًا للعملة في صفحة الدفع. يتحول السعر إلى العملة التي يختارونها وفق أسعار الصرف الأجنبي المباشرة. إذا تم تفعيل Purchasing Power Parity للمنتج، يتحول السعر المعدّل وفق PPP بدلًا من السعر الأساسي. وإذا تم تفعيل Charm Pricing، يُقرّب المبلغ المحوّل إلى نهاية ملائمة مثل 49.99.
محدد العملة في صفحة الدفع
لتفعيل Adaptive Currency، انتقل إلى Settings → Business وفعّل الخيار.

Adaptive Currency

العملات المدعومة، ورسوم التحويل، ومعالجة عمليات رد المبالغ.

الدفع متعدد اللغات

يدعم الدفع 22 لغة. ويمكن للعملاء تبديل اللغة مباشرةً من الصفحة، كما تتم ترجمة نصوص واجهة المستخدم والتسميات ورسائل النظام.
محدد اللغة في صفحة الدفع

اللغات المدعومة

لفرض لغة معينة، عيّن customization.force_language عند إنشاء جلسة دفع. راجع Checkout Sessions API لمزيد من التفاصيل.

حساب الضرائب تلقائيًا

يتم حساب الضرائب تلقائيًا بناءً على موقع فوترة العميل، بما يضمن الامتثال لمتطلبات GST وVAT وضريبة المبيعات. تُطبّق القواعد الضريبية بناءً على بلد العميل ومنطقته، حيثما ينطبق ذلك. ويتم تحديث مبلغ الضريبة تلقائيًا عندما يغيّر العميل بلده أو يحدّث عنوانه. ويُعرض التفصيل النهائي للضريبة بوضوح قبل الدفع.
حساب الضرائب مؤتمت بالكامل. لا يلزم إعداد يدوي للسلع الرقمية ومنتجات SaaS القياسية.

دعم Business Tax ID

بالنسبة إلى معاملات B2B، تتيح صفحة الدفع للعملاء إدخال Business Tax ID الخاص بهم، مثل رقم VAT أو GST. عند إدخاله، يتم التحقق من الرقم الضريبي في الوقت الفعلي، وتُطبّق تلقائيًا الإعفاءات الضريبية أو قواعد الاحتساب العكسي المنطبقة.
إدخال Business Tax ID في صفحة الدفع

رموز الخصم

يمكن للعملاء تطبيق رموز الخصم أو الرموز الترويجية التي أنشأتها في لوحة التحكم. يتم التحقق من الخصم فورًا ويُعرض السعر المحدّث. عند تفعيل Purchasing Power Parity لمنتج ما، يُطبّق الخصم على السعر المعدّل وفق PPP، وليس على السعر الأساسي.
إدخال رمز الخصم في صفحة الدفع
يمكنك تطبيق رموز الخصم مسبقًا أو تفعيل حقل إدخال الخصم عبر API:
يقبل discount_codes مصفوفة تضم ما يصل إلى 20 رمزًا، ويتم تجميعها بالترتيب. أما الحقل المفرد discount_code فهو مهمل، لكنه لا يزال يعمل للتوافق مع الإصدارات السابقة.

Discount Codes

أنشئ رموز الخصم وأدرها.

Validate Discount by Code

ابحث عن الخصومات وتحقق منها باستخدام أسماء الرموز.

جمع العناوين الذكي

تدعم صفحة الدفع إدخال العناوين بمرونة لتحقيق التوازن بين السرعة والدقة والتغطية العالمية.

الخيارات

وضع العنوان المختصر

لتحقيق أعلى معدل تحويل، فعّل جمع العناوين المختصر لتقليل الاحتكاك أثناء الدفع. عند تعيين minimal_address إلى true، تجمع صفحة الدفع فقط:
  • البلد — مطلوب دائمًا لتحديد الضرائب
  • الرمز البريدي — في المناطق التي يلزم فيها فقط لحساب ضريبة المبيعات أو VAT أو GST
يتم تخطي جميع حقول العنوان الأخرى.
وضع العنوان المختصر الذي يعرض حقلي البلد والرمز البريدي فقط في صفحة الدفع
جمع العنوان الكامل هو الإعداد الافتراضي. فعّل minimal_address للمنتجات الرقمية وتدفقات SaaS التي لا تتطلب تفاصيل فوترة كاملة.

جمع أرقام الهواتف

تحكم في ظهور حقل رقم الهاتف في صفحة الدفع وما إذا كان مطلوبًا.
يتطلب require_phone_number: true تعيين allow_phone_number_collection: true. ترفض API الجلسات التي يكون فيها جمع رقم الهاتف معطلًا بينما يكون رقم الهاتف مطلوبًا.

الحقول المخصصة

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

أنواع الحقول المتاحة

مثال

تُضمّن إجابات العملاء تلقائيًا في حمولات webhook ‏(payment.succeeded وsubscription.active) وفي استجابات API عبر مصفوفة custom_field_responses. يمكنك تعريف ما يصل إلى 5 حقول مخصصة لكل جلسة دفع.

Custom Fields Guide

إعداد الحقول المخصصة والوصول إلى الإجابات.

قبول سياسة الخصوصية والشروط

لضمان الشفافية القانونية والامتثال:
  • يتم عرض رابطَي Privacy Policy وBuyer Terms بوضوح في صفحة الدفع
  • يقرّ العملاء بهذين المستندين صراحةً قبل إتمام الدفع
يساعد ذلك على تلبية متطلبات حماية المستهلك وخصوصية البيانات عالميًا، بما في ذلك الامتثال للائحة GDPR.

مجموعات المنتجات

تتيح مجموعات المنتجات تجربة دفع موحّدة، حيث يمكن للعملاء عرض عدة منتجات مرتبطة واختيارها، مثل خطط Starter وPro وEnterprise، ضمن عملية دفع واحدة. عند استخدام مجموعة، تُعرض جميع المنتجات النشطة فيها. ويتم تحديد المنتج الأول مسبقًا، ويمكن للعملاء مقارنة الخيارات قبل الاختيار.
عند استخدام product_collection_id، مرّر مصفوفة product_cart فارغة. لا يمكن تطبيق رموز الخصم مسبقًا عند إنشاء الجلسة.

Product Collections

أنشئ مجموعات المنتجات وأدرها.

إعداد جلسة الدفع

تحكم في سلوك الدفع باستخدام Checkout Sessions API:
بعد الدفع، تتم إعادة توجيه العملاء إلى return_url مع إلحاق معلمات الاستعلام تلقائيًا، بما في ذلك payment_id أو subscription_id، وstatus، وemail، وlicense_key، إن أمكن. راجع دليل Checkout Sessions للاطلاع على القائمة الكاملة.

Checkout Sessions API

مرجع API الكامل لجلسات الدفع.

Checkout Integration Guide

دليل تفصيلي خطوة بخطوة لدمج الدفع.

تخصيص المظهر

خصّص مظهر صفحة الدفع ليتوافق مع علامتك التجارية باستخدام معلمة customization.theme_config. يمكنك إعداد الألوان والخطوط ونصف قطر الحدود ونص الزر لكل من الوضعين الفاتح والداكن. يغطي هذا القسم API من جهة الخادم، الذي يستخدم أسماء خصائص مثل bg_primary. ويُطبّق المظهر المحدد في الجلسة على صفحات الدفع المستضافة وطبقة التراكب والدفع المضمّن. أما خيار themeConfig من جهة العميل في Checkout SDK، والذي يستخدم أسماء خصائص مثل bgPrimary، فهو مهمل. راجع Overlay Checkout.
صفحة دفع بمظهر مخصص

Design & Theme Customization

اضبط المظاهر بصريًا من لوحة التحكم باستخدام مظاهر مُعدّة مسبقًا وخيارات الطباعة والألوان والمعاينة المباشرة.

خيارات إعداد المظهر

إعداد الألوان (الوضع الفاتح/الداكن)

يدعم كل وضع خصائص الألوان التالية:
تقبل جميع حقول الألوان تنسيقات ألوان 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

مثال

لا تحتاج إلى تحديد جميع خصائص الألوان. تستخدم الخصائص غير المحددة قيم المظهر الافتراضية.
آخر تعديل في ٢٦ سبتمبر ٢٠٢٦