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

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

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

كيف تعمل

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

Adaptive Currency

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

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

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

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

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

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

تدعم صفحة الدفع 21 لغة:
اللغةالرمز
العربيةar
الكاتالونيةca
الصينيةzh
الهولنديةnl
الإنجليزيةen
الفرنسيةfr
الألمانيةde
العبريةhe
الإندونيسيةid
الإيطاليةit
اليابانيةja
الكوريةko
الملايوms
البولنديةpl
البرتغاليةpt
الرومانيةro
الروسيةru
الإسبانيةes
السويديةsv
التايلانديةth
التركيةtr
يمكنك فرض لغة معينة على صفحة الدفع عن طريق تعيين معامل force_language عند إنشاء جلسة دفع. راجع واجهة برمجة جلسات الدفع للحصول على التفاصيل.

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

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

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

1

Location Detection

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

Dynamic Updates

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

Transparent Display

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

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

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

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

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

رموز الخصم

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

تجربة الدفع

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

تكامل API

قم بتطبيق رمز خصم مسبقاً أو تمكين حقل إدخال الخصم:
const session = await client.checkoutSessions.create({
  product_cart: [
    { product_id: 'prod_abc', quantity: 1 }
  ],
  discount_code: 'WELCOME20', // Pre-apply a code
  feature_flags: {
    allow_discount_code: true // Show discount input field
  },
  return_url: 'https://yoursite.com/return'
});

Discount Codes

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

Validate Discount by Code

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

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

تدعم صفحة الدفع إدخال العناوين المرن لتسريع عملية الإكمال.

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

الخيارالوصف
ملء العنوان تلقائياً من جوجلاختيار سريع مع الإكمال التلقائي
الإدخال اليدويتحكم كامل للعناوين الكاملة
اختيار البلديحدد منطق الضرائب والامتثال
توازن عملية جمع العناوين بين السرعة والدقة والتغطية العالمية لتعظيم التحويل مع ضمان الامتثال.

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

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

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

النوعالوصف
textحقل نصي بسطر واحد
numberإدخال رقمي
emailعنوان بريد إلكتروني مع التحقق
urlرابط URL مع التحقق
dateمنتقي تاريخ
dropdownاختيار من خيارات محددة مسبقاً
booleanمفتاح نعم/لا

مثال

const session = await client.checkoutSessions.create({
  product_cart: [
    { product_id: 'prod_abc', quantity: 1 }
  ],
  custom_fields: [
    {
      key: 'company_name',
      label: 'Company Name',
      field_type: 'text',
      required: true
    },
    {
      key: 'team_size',
      label: 'Team Size',
      field_type: 'dropdown',
      required: true,
      options: ['1-10', '11-50', '51-200', '200+']
    }
  ],
  return_url: 'https://yoursite.com/return'
});
يتم تضمين ردود العملاء تلقائيًا في حمولات الويب هوك (payment.succeeded، subscription.active) وفي استجابات واجهة برمجة التطبيقات عبر المصفوفة custom_field_responses. يمكنك تعريف ما يصل إلى 5 حقول مخصصة لكل جلسة سداد.

Custom Fields Guide

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

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

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

صفحة دفع المجموعات

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

كيف تعمل

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

إنشاء صفحة دفع مجموعة

const session = await client.checkoutSessions.create({
  product_collection_id: 'pdc_abc123',
  product_cart: [], // Required: pass an empty array for collection checkout
  return_url: 'https://yoursite.com/return'
});
عند استخدام product_collection_id، مرّر مصفوفة product_cart فارغة. لا يمكن تطبيق رموز الخصم مسبقاً عند إنشاء الجلسة.

Product Collections

تعرّف على كيفية إنشاء وإدارة مجموعات المنتجات لتجارب دفع موحدة.

تكوين جلسة الدفع

تحكم في سلوك الدفع باستخدام واجهة Checkout Sessions API:
const session = await client.checkoutSessions.create({
  product_cart: [
    { product_id: 'prod_abc', quantity: 1 }
  ],
  customer: {
    email: 'customer@example.com',
    name: 'Jane Doe'
  },
  billing_currency: 'EUR', // Set specific currency
  discount_code: 'PROMO10',
  feature_flags: {
    allow_discount_code: true
  },
  return_url: 'https://yoursite.com/return',
  metadata: {
    order_ref: 'ORD-12345'
  }
});
بعد الدفع، يُعاد توجيه العملاء إلى return_url مع إضافات بارامترات الاستعلام تلقائياً — بما في ذلك payment_id أو subscription_id، status، email، وlicense_key (إذا انطبق). راجع دليل جلسات الدفع للقائمة الكاملة.

تخصيص ثيم صفحة الدفع

خصص مظهر صفحة الدفع ليتوافق مع علامتك التجارية باستخدام معامل customization.theme_config عند إنشاء جلسة الدفع عبر API. قم بتكوين الألوان والخطوط ونصف قطر الحدود ونص الزر لكل من الوضع الفاتح والغامق.
صفحة دفع مخصصة

Design & Theme Customization

قم بتكوين السمات بصريًا من لوحة التحكم باستخدام سمات جاهزة وخطوط وألوان ومعاينة مباشرة.
يغطي هذا القسم تكوين السمة الخاص بـ واجهة برمجة التطبيقات على جانب الخادم باستخدام customization.theme_config. إذا كنت تستخدم SDK الدفع (التراكب أو الدفع المضمّن)، فراجع أقسام تخصيص السمة في Overlay Checkout أو Inline Checkout التي تستخدم خصائص camelCase (مثل bgPrimary بدلًا من bg_primary).

خيارات تكوين السمة

PropertyDescription
lightتكوين الألوان لوضع الإضاءة
darkتكوين الألوان لوضع الظلام
font_primary_urlعنوان URL للخط الأساسي
font_secondary_urlعنوان 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) خصائص الألوان التالية:
PropertyDescription
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

مثال

const session = await client.checkoutSessions.create({
  product_cart: [
    { product_id: 'prod_abc', quantity: 1 }
  ],
  customization: {
    theme_config: {
      // Custom fonts
      font_primary_url: 'https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600&display=swap',
      font_size: 'md',
      font_weight: 'medium',
      radius: '8px',
      pay_button_text: 'Complete Purchase',
      
      // Light mode colors
      light: {
        bg_primary: '#ffffff',
        bg_secondary: '#f5f5f5',
        text_primary: '#1a1a1a',
        text_secondary: '#666666',
        button_primary: '#0066ff',
        button_primary_hover: '#0052cc',
        button_text_primary: '#ffffff',
        border_primary: '#e0e0e0'
      },
      
      // Dark mode colors
      dark: {
        bg_primary: '#1a1a1a',
        bg_secondary: '#2d2d2d',
        text_primary: '#ffffff',
        text_secondary: '#a0a0a0',
        button_primary: '#3385ff',
        button_primary_hover: '#4d99ff',
        button_text_primary: '#ffffff',
        border_primary: '#404040'
      }
    }
  },
  return_url: 'https://yoursite.com/return'
});
لا تحتاج إلى تحديد جميع خصائص اللون. أي خصائص غير محددة ستستخدم قيم السمة الافتراضية.