
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
العملات المدعومة، ورسوم التحويل، ومعالجة عمليات رد المبالغ.
الدفع متعدد اللغات
يدعم الدفع 22 لغة. ويمكن للعملاء تبديل اللغة مباشرةً من الصفحة، كما تتم ترجمة نصوص واجهة المستخدم والتسميات ورسائل النظام.
اللغات المدعومة
لفرض لغة معينة، عيّن
customization.force_language عند إنشاء جلسة دفع. راجع Checkout Sessions API لمزيد من التفاصيل.
حساب الضرائب تلقائيًا
يتم حساب الضرائب تلقائيًا بناءً على موقع فوترة العميل، بما يضمن الامتثال لمتطلبات GST وVAT وضريبة المبيعات. تُطبّق القواعد الضريبية بناءً على بلد العميل ومنطقته، حيثما ينطبق ذلك. ويتم تحديث مبلغ الضريبة تلقائيًا عندما يغيّر العميل بلده أو يحدّث عنوانه. ويُعرض التفصيل النهائي للضريبة بوضوح قبل الدفع.دعم Business Tax ID
بالنسبة إلى معاملات B2B، تتيح صفحة الدفع للعملاء إدخال Business Tax ID الخاص بهم، مثل رقم VAT أو GST. عند إدخاله، يتم التحقق من الرقم الضريبي في الوقت الفعلي، وتُطبّق تلقائيًا الإعفاءات الضريبية أو قواعد الاحتساب العكسي المنطبقة.
رموز الخصم
يمكن للعملاء تطبيق رموز الخصم أو الرموز الترويجية التي أنشأتها في لوحة التحكم. يتم التحقق من الخصم فورًا ويُعرض السعر المحدّث. عند تفعيل Purchasing Power Parity لمنتج ما، يُطبّق الخصم على السعر المعدّل وفق PPP، وليس على السعر الأساسي.
يقبل
discount_codes مصفوفة تضم ما يصل إلى 20 رمزًا، ويتم تجميعها بالترتيب. أما الحقل المفرد discount_code فهو مهمل، لكنه لا يزال يعمل للتوافق مع الإصدارات السابقة.Discount Codes
أنشئ رموز الخصم وأدرها.
Validate Discount by Code
ابحث عن الخصومات وتحقق منها باستخدام أسماء الرموز.
جمع العناوين الذكي
تدعم صفحة الدفع إدخال العناوين بمرونة لتحقيق التوازن بين السرعة والدقة والتغطية العالمية.الخيارات
وضع العنوان المختصر
لتحقيق أعلى معدل تحويل، فعّل جمع العناوين المختصر لتقليل الاحتكاك أثناء الدفع. عند تعيينminimal_address إلى true، تجمع صفحة الدفع فقط:
- البلد — مطلوب دائمًا لتحديد الضرائب
- الرمز البريدي — في المناطق التي يلزم فيها فقط لحساب ضريبة المبيعات أو VAT أو GST

جمع العنوان الكامل هو الإعداد الافتراضي. فعّل
minimal_address للمنتجات الرقمية وتدفقات SaaS التي لا تتطلب تفاصيل فوترة كاملة.جمع أرقام الهواتف
تحكم في ظهور حقل رقم الهاتف في صفحة الدفع وما إذا كان مطلوبًا.الحقول المخصصة
اجمع معلومات إضافية من العملاء أثناء الدفع عبر تعريف حقول نموذج مخصصة. يفيد ذلك في جمع اسم الشركة أو حجم الفريق أو مصدر الإحالة أو أي بيانات أخرى خاصة بنشاطك التجاري.أنواع الحقول المتاحة
مثال
تُضمّن إجابات العملاء تلقائيًا في حمولات webhook (
payment.succeeded وsubscription.active) وفي استجابات API عبر مصفوفة custom_field_responses. يمكنك تعريف ما يصل إلى 5 حقول مخصصة لكل جلسة دفع.Custom Fields Guide
إعداد الحقول المخصصة والوصول إلى الإجابات.
قبول سياسة الخصوصية والشروط
لضمان الشفافية القانونية والامتثال:- يتم عرض رابطَي Privacy Policy وBuyer Terms بوضوح في صفحة الدفع
- يقرّ العملاء بهذين المستندين صراحةً قبل إتمام الدفع
يساعد ذلك على تلبية متطلبات حماية المستهلك وخصوصية البيانات عالميًا، بما في ذلك الامتثال للائحة GDPR.
مجموعات المنتجات
تتيح مجموعات المنتجات تجربة دفع موحّدة، حيث يمكن للعملاء عرض عدة منتجات مرتبطة واختيارها، مثل خطط Starter وPro وEnterprise، ضمن عملية دفع واحدة. عند استخدام مجموعة، تُعرض جميع المنتجات النشطة فيها. ويتم تحديد المنتج الأول مسبقًا، ويمكن للعملاء مقارنة الخيارات قبل الاختيار.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