الانتقال إلى المحتوى الرئيسي
صفحة الدفع
دفع دودو هو صفحة دفع مصممة لتعظيم التحويل والامتثال العالمي موجهة للمنتجات الرقمية وشركات SaaS. تدعم عملات ولغات وضرائب وخصومات وإضافات متعددة، بالإضافة إلى سير عمل امتثال مناسب للأعمال.

Checkout Sessions API

قم بإنشاء جلسات دفع مستضافة برمجياً.

Preview Checkout

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

Payment Methods

طرق الدفع المدعومة وخيارات التكوين.

العملة التكيفية

تسمح العملة التكيفية للعملاء بالدفع بعملتهم المحلية المفضلة، مما يعزز الثقة ومعدلات التحويل.

كيف تعمل

  1. تمكين: قم بتمكين العملة التكيفية من الإعدادات → الأعمال
  2. اختيار: يمكن للعملاء تبديل العملات مباشرة عند الخروج
  3. تحويل: يتم تحويل الأسعار ديناميكيًا باستخدام أسعار العملات الحية
  4. عرض: يتم عرض المبلغ النهائي المستحق بشفافية قبل الدفع
محدد العملة عند الخروج

Adaptive Currency

تعرف على المزيد حول العملات المدعومة ورسوم التحويل والتعامل مع الاسترداد.

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

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

النقاط الرئيسية

  • محدد اللغة متاح مباشرة عند الدفع
  • النصوص، والعناوين، ورسائل النظام محلية
  • يحسن الوصول والتحويل الدولي

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

تدعم صفحة الدفع 21 لغة:
يمكنك فرض لغة معينة على صفحة الدفع عن طريق تعيين معامل force_language عند إنشاء جلسة دفع. راجع واجهة برمجة جلسات الدفع للحصول على التفاصيل.

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

يتم حساب الضرائب تلقائياً بناءً على موقع دفع العميل، مما يضمن الامتثال لمتطلبات GST وVAT وضريبة المبيعات دون إعداد يدوي.

كيف يعمل حساب الضرائب

1

Location Detection

تُطبق قواعد الضرائب بناءً على بلد العميل (والمنطقة عند الضرورة).
2

Dynamic Updates

يتم تحديث مبلغ الضريبة تلقائياً عندما:
  • يتغير البلد
  • يتم تحديث العنوان
3

Transparent Display

يتم عرض تفصيل الضريبة النهائي بوضوح قبل الدفع.
يتم أتمتة حساب الضرائب بالكامل. لا حاجة لأي تكوين يدوي للسلع الرقمية القياسية ومنتجات SaaS.

دعم رقم تعريف الضريبة للأعمال

بالنسبة للأعمال المسجلة، تتيح صفحة الدفع للعملاء إدخال رقم تعريف ضريبة العمل (مثل رقم VAT/GST).

ماذا يحدث عند إدخال رقم الضريبة

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

رموز الخصم

يمكن للعملاء تطبيق رموز الخصم أو الترويج التي أنشأتها في لوحة التحكم مباشرة على صفحة الدفع.

تجربة الدفع

  1. يدخل العميل رمز الخصم
  2. يتم التحقق من الخصم فوراً
  3. يتم عرض السعر المحدث والمدخرات بوضوح
إدخال رمز الخصم عند الخروج

تكامل API

تطبيق مسبقًا لرمز خصم واحد أو أكثر أو تفعيل حقل إدخال الخصم:
discount_codes يستقبل مجموعة تصل إلى 20 رمزًا مكدسًا بالترتيب. الحقل الفردي discount_code تم إهماله لكنه لا يزال يعمل — ليس من الضروري تغيير التكاملات الحالية على الفور. انتقل إلى discount_codes عند التمكن من استخدام التكديس والشكل الأغنى للاستجابة.

Discount Codes

تعلّم كيفية إنشاء وإدارة رموز الخصم.

Validate Discount by Code

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

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

يدعم الدفع إدخال العناوين بمرونة لإكمالها بشكل أسرع.

الخيارات المتاحة

جمع العناوين يوازن بين السرعة والدقة والتغطية العالمية لتعظيم التحويل مع ضمان الامتثال.

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

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

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

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

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

مثال

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

Custom Fields Guide

تعرّف على المزيد حول تكوين الحقول المخصصة والوصول إلى الردود.

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

لضمان شفافية الامتثال القانوني:
يساعد هذا في تلبية متطلبات حماية المستهلك العالمية ومتطلبات خصوصية البيانات بما في ذلك التوافق مع GDPR.

دفع التجميع

تمكّن مجموعات المنتجات من تجربة دفع موحدة حيث يمكن للعملاء عرض واختيار من بين منتجات متعددة ذات صلة (مثل خطط Starter وPro وEnterprise) في دفع واحد.

كيف تعمل

  1. عرض جميع المنتجات: يشاهد العملاء كل منتج نشط في المجموعة
  2. تم اختيار المنتج الأول مسبقًا: يتم اختيار المنتج الأول في المجموعة تلقائيًا
  3. مقارنة الخيارات: يمكن للعملاء مقارنة الأسعار والميزات قبل الاختيار
  4. اختيار واحد: بعد اختيار المنتج، يتم المتابعة بالدفع بالطريقة القياسية

إنشاء دفع مجموعات

عند استخدام product_collection_id، مرر مصفوفة product_cart فارغة. لا يمكن تطبيق رموز الخصم مسبقًا عند إنشاء الجلسة.

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

مثال

تتناول هذه القسم إعدادات موضوع API للجانب الخادم باستخدام customization.theme_config. إذا كنت تستخدم Checkout SDK (الإطار المتداخل أو الشراء المضمن)، انظر قسم تخصيص الموضوع في 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

المثال

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