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 القياسية.

دعم المعرّف الضريبي للنشاط التجاري

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

رموز الخصم

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

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

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

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

مثال

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