Checkout Sessions

Quick Start Guide

Get your first checkout session running in under 5 minutes

API Reference & Live Testing

Explore the full API documentation and interactively test Checkout Session requests and responses.

Preview Checkout

Calculate pricing, taxes, and totals before creating a session.

Session Validity: Checkout sessions are valid for 24 hours by default. If you pass confirm=true in your request, the session will only be valid for 15 minutes.

الروابط ذات الاستخدام الواحد: إن checkout_url الذي تُرجعه API غير قابل لإعادة الاستخدام وتنتهي صلاحيته خلال 24 ساعة (أو 15 دقيقة عند confirm=true). وهو مخصص لعميل واحد لإتمام دفعة واحدة. أنشئ جلسة checkout جديدة لكل عميل ولكل محاولة دفع، بدلاً من مشاركة الرابط أو إعادة استخدامه.

المتطلبات الأساسية

Dodo Payments Account

ستحتاج إلى حساب تاجر نشط لدى Dodo Payments مع إمكانية الوصول إلى API.

API Credentials

أنشئ بيانات اعتماد API من لوحة تحكم Dodo Payments:

Products Setup

أنشئ منتجاتك في لوحة تحكم Dodo Payments قبل تنفيذ جلسات checkout.

إنشاء أول جلسة Checkout

Node.js SDK
Python SDK
REST API

import DodoPayments from 'dodopayments';

// Initialize the Dodo Payments client
const client = new DodoPayments({
  bearerToken: process.env.DODO_PAYMENTS_API_KEY,
  environment: 'test_mode', // defaults to 'live_mode'
});

async function createCheckoutSession() {
  try {
    const session = await client.checkoutSessions.create({
      // Products to sell - use IDs from your Dodo Payments dashboard
      product_cart: [
        {
          product_id: 'pdt_123', // Replace with your actual product ID
          quantity: 1
        }
      ],
      
      // Pre-fill customer information to reduce friction
      customer: {
        email: 'customer@example.com',
        name: 'John Doe',
        phone_number: '+1234567890'
      },
      
      // Billing address for tax calculation and compliance
      billing_address: {
        street: '123 Main St',
        city: 'San Francisco',
        state: 'CA',
        country: 'US', // Required: ISO 3166-1 alpha-2 country code
        zipcode: '94102'
      },
      
      // Where to redirect after successful payment
      return_url: 'https://yoursite.com/checkout/success',
      
      // Custom data for your internal tracking
      metadata: {
        order_id: 'order_123',
        source: 'web_app'
      }
    });

    // Redirect your customer to this URL to complete payment
    console.log('Checkout URL:', session.checkout_url);
    console.log('Session ID:', session.session_id);
    
    return session;
    
  } catch (error) {
    console.error('Failed to create checkout session:', error);
    throw error;
  }
}

// Example usage in an Express.js route
app.post('/create-checkout', async (req, res) => {
  try {
    const session = await createCheckoutSession();
    res.json({ checkout_url: session.checkout_url });
  } catch (error) {
    res.status(500).json({ error: 'Failed to create checkout session' });
  }
});

import os
from dodopayments import DodoPayments

# Initialize the Dodo Payments client
client = DodoPayments(
    bearer_token=os.environ.get("DODO_PAYMENTS_API_KEY"),  # This is the default and can be omitted
    environment="test_mode",  # defaults to "live_mode"
)

def create_checkout_session():
    """
    Create a checkout session for a single product with customer data pre-filled.
    Returns the session object containing checkout_url for customer redirection.
    """
    try:
        session = client.checkout_sessions.create(
            # Products to sell - use IDs from your Dodo Payments dashboard
            product_cart=[
                {
                    "product_id": "pdt_123",  # Replace with your actual product ID
                    "quantity": 1
                }
            ],
            
            # Pre-fill customer information to reduce checkout friction
            customer={
                "email": "customer@example.com",
                "name": "John Doe",
                "phone_number": "+1234567890"
            },
            
            # Billing address for tax calculation and compliance
            billing_address={
                "street": "123 Main St",
                "city": "San Francisco", 
                "state": "CA",
                "country": "US",  # Required: ISO 3166-1 alpha-2 country code
                "zipcode": "94102"
            },
            
            # Where to redirect after successful payment
            return_url="https://yoursite.com/checkout/success",
            
            # Custom data for your internal tracking
            metadata={
                "order_id": "order_123",
                "source": "web_app"
            }
        )
        
        # Redirect your customer to this URL to complete payment
        print(f"Checkout URL: {session.checkout_url}")
        print(f"Session ID: {session.session_id}")
        
        return session
        
    except Exception as error:
        print(f"Failed to create checkout session: {error}")
        raise error

# Example usage in a Flask route
from flask import Flask, jsonify, request

app = Flask(__name__)

@app.route('/create-checkout', methods=['POST'])
def create_checkout():
    try:
        session = create_checkout_session()
        return jsonify({"checkout_url": session.checkout_url})
    except Exception as error:
        return jsonify({"error": "Failed to create checkout session"}), 500

// Direct API call using fetch - useful for any JavaScript environment
async function createCheckoutSession() {
  try {
    const response = await fetch('https://test.dodopayments.com/checkouts', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': `Bearer ${process.env.DODO_PAYMENTS_API_KEY}`
      },
      body: JSON.stringify({
        // Products to sell - use IDs from your Dodo Payments dashboard
        product_cart: [
          {
            product_id: 'pdt_123', // Replace with your actual product ID
            quantity: 1
          }
        ],
        
        // Pre-fill customer information to reduce checkout friction
        customer: {
          email: 'customer@example.com',
          name: 'John Doe',
          phone_number: '+1234567890'
        },
        
        // Billing address for tax calculation and compliance
        billing_address: {
          street: '123 Main St',
          city: 'San Francisco',
          state: 'CA', 
          country: 'US', // Required: ISO 3166-1 alpha-2 country code
          zipcode: '94102'
        },
        
        // Where to redirect after successful payment
        return_url: 'https://yoursite.com/checkout/success',
        
        // Custom data for your internal tracking
        metadata: {
          order_id: 'order_123',
          source: 'web_app'
        }
      })
    });

    if (!response.ok) {
      throw new Error(`HTTP error! status: ${response.status}`);
    }

    const session = await response.json();
    
    // Redirect your customer to this URL to complete payment
    console.log('Checkout URL:', session.checkout_url);
    console.log('Session ID:', session.session_id);
    
    return session;
    
  } catch (error) {
    console.error('Failed to create checkout session:', error);
    throw error;
  }
}

// Example: Redirect user to checkout
createCheckoutSession().then(session => {
  window.location.href = session.checkout_url;
});

استجابة API

تعيد جميع الطرق أعلاه بنية الاستجابة نفسها:

{
  "session_id": "cks_Gi6KGJ2zFJo9rq9Ukifwa",
  "checkout_url": "https://test.checkout.dodopayments.com/session/cks_Gi6KGJ2zFJo9rq9Ukifwa"
}

لا يُضمن وجود سوى session_id. تُعيد حالتان حقولًا إضافية أو أقل:

تم توفير payment_method_id — تتم معالجة الرسوم فورًا ويكون checkout_url هو null. استخدم payment_id المُعاد بدلًا منه.
أنشأ confirm: true عملية الدفع وقت إنشاء الجلسة — تتضمن الاستجابة أيضًا payment_id وclient_secret وpublishable_key لاستخدامها مع Dodo Payments checkout SDK.

إن checkout_url المُنشأ صالح للاستخدام مرة واحدة وتنتهي صلاحيته خلال 24 ساعة. لا تُخزّنه مؤقتًا أو تعِد استخدامه بين العملاء أو محاولات الدفع — أنشئ جلسة checkout جديدة كلما احتجت إلى رابط جديد.

Get the checkout URL

استخرج checkout_url من استجابة API.

Redirect your customer

وجّه عميلك إلى عنوان URL الخاص بـ checkout لإكمال عملية الشراء.

// Redirect immediately
window.location.href = session.checkout_url;

// Or open in new window
window.open(session.checkout_url, '_blank');

خيارات التكامل البديلة: بدلًا من إعادة التوجيه، يمكنك تضمين checkout مباشرةً في صفحتك باستخدام Overlay Checkout (تراكب مشروط) أو Inline Checkout (تضمين كامل). وفي تطبيق جوّال أصلي، مرّر عنوان URL نفسه إلى Mobile Checkout SDKs لنظام Android أو iOS أو React Native أو Flutter. تستخدم جميع هذه الخيارات عنوان URL نفسه لجلسة checkout.

Handle the return

بعد الدفع، تتم إعادة توجيه العملاء إلى return_url الخاص بك مع query parameters تتضمن معرّف الدفع/الاشتراك، والحالة، والبريد الإلكتروني للعميل، وأي مفاتيح ترخيص. راجع مستندات parameters الخاصة بـ return_url للاطلاع على القائمة الكاملة.

نص الطلب

Required Fields

الحقول الأساسية المطلوبة لكل جلسة checkout

Optional Fields

إعدادات إضافية لتخصيص تجربة checkout

الحقول المطلوبة

array

مطلوب

مصفوفة المنتجات المطلوب تضمينها في جلسة checkout. يجب أن يتضمن كل منتج product_id صالحًا من لوحة تحكم Dodo Payments.

Checkout المختلط: يمكنك الجمع بين منتجات الدفع لمرة واحدة ومنتجات الاشتراك في جلسة checkout نفسها. يتيح ذلك حالات استخدام قوية مثل رسوم الإعداد مع الاشتراكات، وحزم الأجهزة مع SaaS، وغير ذلك.

إظهار Product Cart Item Properties

string

مطلوب

المعرّف الفريد للمنتج من لوحة تحكم Dodo Payments.مثال: "pdt_123abc456def"

integer

مطلوب

كمية المنتج.مثال: 1 لعنصر واحد، و3 لكميات متعددة

array

مصفوفة الإضافات التي سيتم إرفاقها بالمنتج. تكون صالحة فقط إذا كان المنتج اشتراكًا.

إظهار Addon item properties

string

مطلوب

integer

مطلوب

integer

المبلغ الذي يدفعه العميل عند تفعيل pay_what_you_want. إذا كان معطلًا، فسيتم تجاهل هذا الحقل.التنسيق: يُمثّل بأصغر فئة من العملة (مثل السنتات بالنسبة إلى USD). لشحن $1.00، مرّر 100.

array

تجاوزات خاصة بكل جلسة checkout للاستحقاقات الائتمانية المرتبطة مسبقًا بهذا المنتج. استخدم ذلك لمنح عدد مختلف من الأرصدة لهذه الجلسة فقط — مثل حزمة ترويجية تمنح 1,000 رصيد API بدلًا من 500 الافتراضية للمنتج — دون إنشاء منتج منفصل.

يجب أن يكون كل credit_entitlement_id مرتبطًا بالمنتج مسبقًا. يتجاوز هذا الحقل فقط credits_amount الممنوح عند إتمام هذه الجلسة؛ وتظل إعدادات استحقاقات الائتمان على مستوى المنتج (انتهاء الصلاحية، والترحيل، وغير ذلك) سارية.

إظهار Credit entitlement override properties

string

مطلوب

معرّف استحقاق الائتمان المطلوب تجاوزه. يجب أن يكون مرتبطًا بالمنتج مسبقًا.

string

مطلوب

عدد الأرصدة المطلوب منحها لهذه الجلسة، متجاوزًا credits_amount على مستوى المنتج. يجب أن يكون أكبر من صفر.

العثور على معرّفات المنتجات: يمكنك العثور على معرّفات المنتجات في لوحة تحكم Dodo Payments ضمن Products → View Details، أو باستخدام List Products API.

الحقول الاختيارية

اضبط هذه الحقول لتخصيص تجربة checkout وإضافة منطق الأعمال إلى تدفق الدفع.

Customer Information

object

معلومات العميل. يمكنك إما إرفاق عميل موجود باستخدام معرّفه أو إنشاء سجل عميل جديد أثناء checkout.

Attach Existing Customer
New Customer

أرفق عميلًا موجودًا بجلسة checkout باستخدام معرّفه.

إظهار Existing Customer Properties

string

مطلوب

المعرّف الفريد لعميل موجود. استخدمه لإرفاق جلسة checkout بعميل موجود بدلًا من إنشاء عميل جديد.

أنشئ سجل عميل جديدًا أثناء checkout.

إظهار New Customer Properties

string

مطلوب

عنوان البريد الإلكتروني للعميل. مطلوب عند إنشاء عميل جديد.

string

الاسم الكامل للعميل كما ينبغي أن يظهر على الإيصالات والفواتير.مثال: "John Doe" أو "Jane Smith"

string

رقم هاتف العميل بالتنسيق الدولي. مطلوب لبعض طرق الدفع ولمنع الاحتيال.التنسيق: أدرج رمز الدولة، مثل "+1234567890" لأرقام الولايات المتحدة

object

معلومات عنوان الفوترة لحساب الضرائب بدقة، ومنع الاحتيال، والامتثال للمتطلبات التنظيمية.

عند ضبط confirm على true، تصبح جميع حقول عنوان الفوترة مطلوبة لإنشاء الجلسة بنجاح.

إظهار Billing address object properties

string

عنوان شارع كامل يتضمن رقم المنزل واسم الشارع ورقم الشقة/الوحدة، عند الاقتضاء.مثال: "123 Main St, Apt 4B" أو "456 Oak Avenue"

string

اسم المدينة أو البلدية.مثال: "San Francisco"، "New York"، "London"

string

اسم الولاية أو المقاطعة أو المنطقة. استخدم الأسماء الكاملة أو الاختصارات القياسية.مثال: "California" أو "CA"، "Ontario" أو "ON"

string

مطلوب

رمز الدولة المكوّن من حرفين وفق ISO (ISO 3166-1 alpha-2). هذا الحقل مطلوب دائمًا عند توفير billing_address.أمثلة: "US" (الولايات المتحدة)، "CA" (كندا)، "GB" (المملكة المتحدة)، "DE" (ألمانيا)

Country Code Reference

عرض القائمة الكاملة للدول المدعومة ورموز ISO الخاصة بها

string

الرمز البريدي أو ZIP أو ما يعادله وفقًا لمتطلبات الدولة.أمثلة: "94102" (الولايات المتحدة)، "M5V 3A8" (كندا)، "SW1A 1AA" (المملكة المتحدة)

Payment Configuration

array

تحكّم في طرق الدفع المتاحة للعملاء أثناء checkout. يساعد ذلك على التحسين لأسواق أو متطلبات أعمال محددة.الخيارات الشائعة: credit، debit، upi_collect، apple_pay، google_pay، amazon_pay، klarna، affirm، afterpay_clearpay، cashapp، ach، multibanco، bancontact_card، eps، ideal، blik، paypal. هذه ليست المجموعة الكاملة — راجع مرجع Create Checkout Session API للاطلاع على كل قيمة مقبولة.

مهم: أدرج دائمًا credit وdebit كخيارات احتياطية لمنع فشل checkout عند عدم توفر طرق الدفع المفضلة.

مثال:

["apple_pay", "google_pay", "credit", "debit"]

string

تجاوز اختيار العملة الافتراضية بعملة فوترة ثابتة. يستخدم رموز العملات وفق ISO 4217.العملات المدعومة: USD، EUR، GBP، CAD، AUD، INR، وغير ذلكمثال: "USD" للدولار الأمريكي، و"EUR" لليورو

لا يكون هذا الحقل فعالًا إلا عند تفعيل adaptive pricing. إذا كان adaptive pricing معطلًا، فسيتم استخدام العملة الافتراضية للمنتج.

boolean

افتراضي:"false"

اعرض طرق الدفع المحفوظة مسبقًا للعملاء العائدين لتحسين سرعة checkout وتجربة المستخدم.

Session Management

string

عنوان URL لإعادة توجيه العملاء بعد إتمام الدفع. يضيف Dodo Payments query parameters التالية إلى عنوان URL عند إعادة التوجيه:

Parameter	Type	Condition
`payment_id`	`string`	موجود دائمًا لعمليات الدفع لمرة واحدة
`subscription_id`	`string`	موجود دائمًا لعمليات دفع الاشتراكات
`status`	`string`	موجود دائمًا
`license_key`	`string`	موجود إذا كانت مفاتيح الترخيص مفعلة للمنتج. تُفصل بفواصل عند وجود مفاتيح متعددة
`email`	`string`	موجود إذا كان للعميل بريد إلكتروني مسجل

أمثلة على عناوين URL لإعادة التوجيه:

# One-time payment with license key
https://yoursite.com/return?payment_id=pay_xxx&status=succeeded&license_key=LK-001&email=customer%40example.com

# Subscription payment with multiple license keys
https://yoursite.com/return?subscription_id=sub_xxx&status=active&license_key=LK-001,LK-002&email=customer%40example.com

# Payment without license keys
https://yoursite.com/return?payment_id=pay_xxx&status=succeeded&email=customer%40example.com

استخدم query parameters ‏license_key وemail لعرض مفاتيح الترخيص أو إرسال تأكيد فورًا في صفحة العودة، دون الحاجة إلى استدعاء API إضافي.

string

عنوان URL لإعادة توجيه العملاء عند النقر على زر الرجوع أو إلغاء جلسة checkout. إذا لم يتم توفيره، فلن يظهر زر الرجوع.

عيّن cancel_url لتوفير طريقة واضحة للعملاء للعودة إلى موقعك دون إكمال عملية الشراء. يحسّن ذلك تجربة checkout ويقلل الاحتكاك.

boolean

افتراضي:"false"

إذا كانت القيمة true، فسيتم إنهاء جميع تفاصيل الجلسة فورًا. سيُصدر API خطأً إذا كانت البيانات المطلوبة مفقودة.

array

طبّق رمز خصم واحدًا أو أكثر بشكل متسلسل على جلسة checkout. تُطبّق الرموز بترتيب المصفوفة (يخفض الرمز الأول السعر الأساسي، ويخفض الثاني السعر بعد الخصم، وهكذا)، بحد أقصى 20 رمزًا لكل جلسة.

discount_codes: ['WELCOME10', 'BLACKFRIDAY20']

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

string

مهمل

مهمل — استخدم discount_codes في عمليات التكامل الجديدة. لا يزال هذا الحقل يعمل للتوافق مع الإصدارات السابقة، لكنه لا يمكن دمجه مع discount_codes في الطلب نفسه.

object

أزواج مخصصة من المفتاح والقيمة لتخزين معلومات إضافية حول الجلسة.

boolean

تجاوز سلوك 3DS الافتراضي للتاجر لهذه الجلسة.

boolean

افتراضي:"false"

فعّل وضع جمع العناوين المختصر. عند تفعيله، يجمع checkout فقط:

الدولة: مطلوبة دائمًا لتحديد الضرائب
الرمز البريدي/ZIP: في المناطق التي يلزم فيها لحساب ضريبة المبيعات أو VAT أو GST فقط

يقلل ذلك احتكاك checkout بشكل ملحوظ من خلال إزالة حقول النموذج غير الضرورية.

فعّل العنوان المختصر لإكمال checkout بسرعة أكبر. يظل جمع العنوان الكامل متاحًا للشركات التي تحتاج إلى تفاصيل فوترة كاملة.

string

طريقة دفع محفوظة تخص العميل المرفق. تتطلب confirm: true وcustomer.customer_id موجودًا. عند ضبطها، تتم معالجة الرسوم فورًا ويُعاد checkout_url كـ null — استخدم payment_id المُعاد بدلًا منه.

boolean

افتراضي:"false"

إذا كانت القيمة true، فأعد عنوان URL مختصرًا لـ checkout بدلًا من عنوان URL الكامل للجلسة.

string

معرّف مجموعة المنتجات لتدفق checkout القائم على المجموعات.

string

معرّف ضريبة العميل (مثل رقم VAT). يتطلب billing_address مع country.

string

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

integer

تجاوز الحد الأدنى لتفويض التاجر (بـ INR paise) الخاص بالتفويضات الإلكترونية بـ INR على البطاقات الهندية.

UI Customization & Features

object

خصّص مظهر واجهة checkout وسلوكها.

إظهار Customization object properties

string

افتراضي:"system"

السمة الخاصة بواجهة checkout. الخيارات: light أو dark أو system.

boolean

افتراضي:"true"

اعرض قسم تفاصيل الطلب في واجهة checkout.

boolean

افتراضي:"true"

اعرض وسم “on-demand” للمنتجات المناسبة.

string

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

object

إعداد سمة مخصصة يتضمن ألوان وضعي الإضاءة والظلام، والخطوط، وتصميم الأزرار. هذا هو البديل من جهة الخادم لخيار themeConfig المهمل من جهة العميل.

إظهار Theme config properties

object

إعداد ألوان وضع الإضاءة.

object

إعداد ألوان وضع الظلام.

string

عنوان URL للخط الأساسي. يجب أن يكون عنوان URL صالحًا من https://.

string

عنوان URL للخط الثانوي. يجب أن يكون عنوان URL صالحًا من https://.

string

حجم الخط لواجهة checkout. الخيارات: xs، sm، md، lg، xl، 2xl.

string

سُمك الخط لواجهة checkout. الخيارات: normal، medium، bold، extraBold.

string

نص مخصص لزر الدفع (مثل "Complete Purchase" أو "Subscribe Now"). بحد أقصى 100 حرف.

string

نصف قطر حدود عناصر الواجهة. رقم متبوع بـ px أو rem أو em (مثل "4px" أو "0.5rem" أو "1em").

object

اضبط الميزات والسلوكيات المحددة لجلسة checkout.

إظهار Feature flags object properties

boolean

افتراضي:"true"

اسمح للعملاء باختيار عملتهم المفضلة أثناء checkout.

boolean

افتراضي:"true"

اعرض حقل إدخال رمز الخصم في واجهة checkout.

boolean

افتراضي:"false"

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

boolean

افتراضي:"true"

اجمع أرقام هواتف العملاء أثناء checkout.

boolean

افتراضي:"false"

اطلب من العميل تقديم رقم هاتف لإكمال checkout. يتطلب أن تكون قيمة allow_phone_number_collection صحيحة أيضًا.

boolean

افتراضي:"true"

اسمح للعملاء بإدخال أرقام التعريف الضريبية.

boolean

افتراضي:"false"

أجبر إنشاء سجل عميل جديد بدلًا من تحديث السجلات الموجودة.

boolean

اسمح للعملاء بتعديل عناوين بريدهم الإلكتروني أثناء checkout.

boolean

اسمح للعملاء بتعديل أسمائهم أثناء checkout.

boolean

اسمح للعملاء بتعديل عنوان الشارع أثناء checkout.

boolean

اسمح للعملاء بتعديل المدينة أثناء checkout.

boolean

اسمح للعملاء بتعديل الولاية أثناء checkout.

boolean

اسمح للعملاء بتعديل الدولة أثناء checkout.

boolean

اسمح للعملاء بتعديل الرمز البريدي أثناء checkout.

boolean

اسمح للعملاء بإدخال معرّفهم الضريبي أو تعديله أثناء checkout.

boolean

افتراضي:"false"

اسمح للعميل بتقديم اسم الشركة المرتبط بالمعرّف الضريبي أو تعديله. يعمل بشكل مستقل عن allow_customer_editing_tax_id — يكفي تفعيل أي من العلمين (أو allow_tax_id). ويُضبط عادةً مع allow_customer_editing_tax_id.

boolean

افتراضي:"false"

تجاوز صفحة نجاح الدفع الافتراضية وأعد توجيه العملاء فورًا إلى return_url بعد إتمام الدفع.

استخدم ذلك عندما تكون لديك صفحة نجاح مخصصة توفر تجربة مستخدم أفضل، أو مع تطبيقات الجوال وتدفقات checkout المضمّنة.

Custom Fields

array

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

إظهار Custom field object properties

string

مطلوب

المعرّف الفريد لهذا الحقل. يُستخدم كمفتاح في حمولات webhooks واستجابات API.مثال: "company_name"، "referral_source"، "team_size"

string

مطلوب

التسمية المعروضة للعميل في نموذج checkout.مثال: "Company Name"، "How did you hear about us?"، "Team Size"

string

مطلوب

نوع الحقل الذي يحدد قواعد التحقق من الإدخال.الأنواع المتاحة:

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

boolean

افتراضي:"false"

ما إذا كان يجب ملء هذا الحقل قبل اكتمال checkout.

string

النص النائب المعروض في حقل الإدخال.

array

قائمة الخيارات لنوع الحقل dropdown. مطلوبة عندما تكون قيمة field_type هي dropdown، ويتم تجاهلها للأنواع الأخرى.مثال: ["Google", "Twitter", "Friend referral", "Other"]

تُدرج إجابات العملاء عن الحقول المخصصة في:

Webhooks: تحتوي payment.succeeded وsubscription.active وحمولات الأحداث الأخرى ذات الصلة على مصفوفة custom_field_responses
استجابات API: تتضمن كائنات الدفع والاشتراك custom_field_responses

Subscription Configuration

object

إعدادات إضافية لجلسات checkout التي تتضمن منتجات الاشتراك.

إظهار Subscription data object properties

integer

عدد أيام فترة التجربة قبل أول رسوم. يجب أن يتراوح بين 0 و10000 يوم.لا يمكن ضبط مبلغ تجربة مدفوعة لكل جلسة — اضبط trial_amount على السعر المتكرر للمنتج بدلًا من ذلك. راجع التجارب المدفوعة.

object

إعدادات اشتراك on-demand للفوترة القائمة على الاستخدام أو المقاسة.

إظهار On-demand object properties

boolean

مطلوب

إذا ضُبطت على true، فلن تُنفّذ أي رسوم، وسيتم تفويض تفاصيل طريقة الدفع فقط لاستخدامها مستقبلًا.

integer

سعر المنتج للرسوم الأولية على العميل. إذا لم يُحدد، فسيُستخدم السعر المخزن للمنتج.التنسيق: يُمثّل بأصغر فئة من العملة (مثل السنتات بالنسبة إلى USD). لشحن $1.00، مرّر 100.

string

عملة اختيارية لسعر المنتج. إذا لم تُحدد، فستكون افتراضيًا عملة المنتج.

string

تجاوز اختياري لوصف المنتج لأغراض الفوترة وبنود الفاتورة. إذا لم يُحدد، فسيُستخدم وصف المنتج المخزن.

boolean

ما إذا كانت رسوم Adaptive Currency مضمنة في سعر المنتج (true) أو مضافة إليه (false). يتم تجاهلها إذا لم يكن Adaptive Currency مفعلًا.

أمثلة على الاستخدام

فيما يلي 10 أمثلة شاملة توضح إعدادات مختلفة لجلسات checkout لسيناريوهات أعمال متعددة:

1. Checkout بسيط لمنتج واحد

const session = await client.checkoutSessions.create({
  product_cart: [
    {
      product_id: 'pdt_ebook_guide',
      quantity: 1
    }
  ],
  customer: {
    email: 'customer@example.com',
    name: 'John Doe'
  },
  return_url: 'https://yoursite.com/success'
});

2. سلة متعددة المنتجات

const session = await client.checkoutSessions.create({
  product_cart: [
    {
      product_id: 'pdt_laptop',
      quantity: 1
    },
    {
      product_id: 'pdt_mouse',
      quantity: 2
    },
    {
      product_id: 'pdt_warranty',
      quantity: 1
    }
  ],
  customer: {
    email: 'customer@example.com',
    name: 'John Doe',
    phone_number: '+1234567890'
  },
  billing_address: {
    street: '123 Tech Street',
    city: 'San Francisco',
    state: 'CA',
    country: 'US',
    zipcode: '94102'
  },
  return_url: 'https://electronics-store.com/order-confirmation'
});

3. اشتراك مع فترة تجريبية

const session = await client.checkoutSessions.create({
  product_cart: [
    {
      product_id: 'pdt_monthly_plan',
      quantity: 1
    }
  ],
  subscription_data: {
    trial_period_days: 14
  },
  customer: {
    email: 'user@startup.com',
    name: 'Jane Smith'
  },
  return_url: 'https://saas-app.com/onboarding',
  metadata: {
    plan_type: 'professional',
    referral_source: 'google_ads'
  }
});

4. Checkout مؤكد مسبقًا

عند ضبط confirm على true، سينتقل العميل مباشرةً إلى صفحة checkout متجاوزًا أي خطوات تأكيد.

const session = await client.checkoutSessions.create({
  product_cart: [
    {
      product_id: 'pdt_premium_course',
      quantity: 1
    }
  ],
  customer: {
    email: 'student@university.edu',
    name: 'Alex Johnson',
    phone_number: '+1555123456'
  },
  billing_address: {
    street: '456 University Ave',
    city: 'Boston',
    state: 'MA',
    country: 'US',
    zipcode: '02134'
  },
  confirm: true,
  return_url: 'https://learning-platform.com/course-access',
  metadata: {
    course_category: 'programming',
    enrollment_date: '2024-01-15'
  }
});

5. Checkout مع تجاوز العملة

لا يسري تجاوز billing_currency إلا عند تفعيل Adaptive Currency في إعدادات حسابك. إذا كان Adaptive Currency معطلًا، فلن يكون لهذا parameter أي تأثير.

const session = await client.checkoutSessions.create({
  product_cart: [
    {
      product_id: 'pdt_consulting_service',
      quantity: 1
    }
  ],
  customer: {
    email: 'client@company.co.uk',
    name: 'Oliver Williams'
  },
  billing_address: {
    street: '789 Business Park',
    city: 'London',
    state: 'England',
    country: 'GB',
    zipcode: 'SW1A 1AA'
  },
  billing_currency: 'GBP',
  feature_flags: {
    allow_currency_selection: true,
    allow_tax_id: true
  },
  return_url: 'https://consulting-firm.com/service-confirmation'
});

6. طرق الدفع المحفوظة للعملاء العائدين

const session = await client.checkoutSessions.create({
  product_cart: [
    {
      product_id: 'pdt_monthly_subscription',
      quantity: 1
    }
  ],
  customer: {
    email: 'returning.customer@example.com',
    name: 'Robert Johnson',
    phone_number: '+1555987654'
  },
  show_saved_payment_methods: true,
  feature_flags: {
    allow_phone_number_collection: true,
    always_create_new_customer: false
  },
  return_url: 'https://subscription-service.com/welcome-back',
  metadata: {
    customer_tier: 'premium',
    account_age: 'returning'
  }
});

7. Checkout للأعمال بين الشركات مع جمع المعرّف الضريبي

const session = await client.checkoutSessions.create({
  product_cart: [
    {
      product_id: 'pdt_enterprise_license',
      quantity: 5
    }
  ],
  customer: {
    email: 'procurement@enterprise.com',
    name: 'Sarah Davis',
    phone_number: '+1800555000'
  },
  billing_address: {
    street: '1000 Corporate Blvd',
    city: 'New York',
    state: 'NY',
    country: 'US',
    zipcode: '10001'
  },
  feature_flags: {
    allow_tax_id: true,
    allow_phone_number_collection: true,
    always_create_new_customer: false
  },
  return_url: 'https://enterprise-software.com/license-delivery',
  metadata: {
    customer_type: 'enterprise',
    contract_id: 'ENT-2024-001',
    sales_rep: 'john.sales@company.com'
  }
});

8. Checkout بالسمة الداكنة مع رموز خصم متسلسلة

const session = await client.checkoutSessions.create({
  product_cart: [
    {
      product_id: 'pdt_gaming_chair',
      quantity: 1
    }
  ],
  discount_codes: ['BLACKFRIDAY2024'],
  customization: {
    theme: 'dark',
    show_order_details: true,
    show_on_demand_tag: false
  },
  feature_flags: {
    allow_discount_code: true
  },
  customer: {
    email: 'gamer@example.com',
    name: 'Mike Chen'
  },
  return_url: 'https://gaming-store.com/order-complete'
});

9. طرق الدفع الإقليمية (UPI للهند)

للحصول على معلومات مفصلة حول إعداد UPI واختباره، راجع صفحة طرق الدفع في الهند.

const session = await client.checkoutSessions.create({
  product_cart: [
    {
      product_id: 'pdt_online_course_hindi',
      quantity: 1
    }
  ],
  allowed_payment_method_types: [
    'upi_collect',
    'credit',
    'debit'
  ],
  customer: {
    email: 'student@example.in',
    name: 'Priya Sharma',
    phone_number: '+919876543210'
  },
  billing_address: {
    street: 'MG Road',
    city: 'Bangalore',
    state: 'Karnataka',
    country: 'IN',
    zipcode: '560001'
  },
  billing_currency: 'INR',
  return_url: 'https://education-platform.in/course-access',
  metadata: {
    region: 'south_india',
    language: 'hindi'
  }
});

10. Checkout باستخدام BNPL (اشترِ الآن وادفع لاحقًا)

للحصول على معلومات مفصلة حول إعداد BNPL واختباره، راجع صفحة اشترِ الآن وادفع لاحقًا (BNPL).

const session = await client.checkoutSessions.create({
  product_cart: [
    {
      product_id: 'pdt_luxury_watch',
      quantity: 1
    }
  ],
  allowed_payment_method_types: [
    'klarna',
    'afterpay_clearpay',
    'credit',
    'debit'
  ],
  customer: {
    email: 'fashion.lover@example.com',
    name: 'Emma Thompson',
    phone_number: '+1234567890'
  },
  billing_address: {
    street: '555 Fashion Ave',
    city: 'Los Angeles',
    state: 'CA',
    country: 'US',
    zipcode: '90210'
  },
  feature_flags: {
    allow_phone_number_collection: true
  },
  return_url: 'https://luxury-store.com/purchase-confirmation',
  metadata: {
    product_category: 'luxury',
    price_range: 'high_value'
  }
});

11. استخدام طرق الدفع الحالية لإجراء Checkout فوري

استخدم طريقة الدفع المحفوظة للعميل لإنشاء جلسة checkout تتم معالجتها فورًا، مع تخطي جمع طريقة الدفع:

const session = await client.checkoutSessions.create({
  product_cart: [
    {
      product_id: 'pdt_premium_plan',
      quantity: 1
    }
  ],
  customer: {
    customer_id: 'cus_123'  // Required when using payment_method_id
  },
  payment_method_id: 'pm_abc123',  // Use customer's saved payment method
  confirm: true,  // Required when using payment_method_id
  return_url: 'https://yourapp.com/success'
});

عند استخدام payment_method_id، يجب ضبط confirm على true، كما يجب توفير customer_id موجود. سيتم التحقق من أهلية طريقة الدفع باستخدام عملة الدفع. وبما أن الرسوم تُعالج فورًا، يُعاد checkout_url كـ null — استخدم payment_id المُعاد بدلًا منه.

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

12. روابط مختصرة لعناوين URL أوضح للدفع

أنشئ روابط دفع مختصرة قابلة للمشاركة باستخدام slugs مخصصة:

const session = await client.checkoutSessions.create({
  product_cart: [
    {
      product_id: 'pdt_monthly_subscription',
      quantity: 1
    }
  ],
  short_link: true,  // Generate a shortened payment link
  return_url: 'https://yourapp.com/success',
  customer: {
    email: 'customer@example.com',
    name: 'John Doe'
  }
});

// The checkout_url will be a shortened, cleaner link
console.log(session.checkout_url);  // e.g., https://checkout.dodopayments.com/buy/abc123

تُعد الروابط المختصرة مناسبة جدًا للمشاركة عبر SMS أو البريد الإلكتروني أو وسائل التواصل الاجتماعي. فهي أسهل في التذكر وتبني ثقة أكبر لدى العملاء مقارنةً بعناوين URL الطويلة.

13. تخطي صفحة نجاح الدفع مع إعادة التوجيه الفورية

أعد توجيه العملاء فورًا بعد إتمام الدفع، متجاوزًا صفحة النجاح الافتراضية:

const session = await client.checkoutSessions.create({
  product_cart: [
    {
      product_id: 'pdt_digital_product',
      quantity: 1
    }
  ],
  feature_flags: {
    redirect_immediately: true  // Skip success page, redirect immediately
  },
  return_url: 'https://yourapp.com/success',
  customer: {
    email: 'customer@example.com',
    name: 'Jane Smith'
  }
});

استخدم redirect_immediately: true عندما تكون لديك صفحة نجاح مخصصة توفر تجربة مستخدم أفضل من صفحة نجاح الدفع الافتراضية. يفيد ذلك خصوصًا مع تطبيقات الجوال وتدفقات checkout المضمّنة.

عند تفعيل redirect_immediately، تتم إعادة توجيه العملاء إلى return_url فورًا بعد إتمام الدفع، مع تخطي صفحة النجاح الافتراضية بالكامل.

14. فرض لغة محددة

أجبر checkout على العرض بلغة محددة، متجاوزًا اكتشاف لغة متصفح العميل:

const session = await client.checkoutSessions.create({
  product_cart: [
    {
      product_id: 'pdt_subscription',
      quantity: 1
    }
  ],
  customization: {
    force_language: 'ja'  // Force Japanese language
  },
  customer: {
    email: 'customer@example.jp',
    name: 'Tanaka Yuki'
  },
  return_url: 'https://yourapp.com/success'
});

استخدم force_language عندما تعرف اللغة المفضلة لعميلك (مثلًا من إعدادات حسابه) أو عندما تستهدف أسواقًا إقليمية محددة.

اللغات المدعومة: العربية (ar)، الكاتالونية (ca)، الصينية (zh)، الهولندية (nl)، الإنجليزية (en)، الفرنسية (fr)، الألمانية (de)، العبرية (he)، الإندونيسية (id)، الإيطالية (it)، اليابانية (ja)، الكورية (ko)، الملايوية (ms)، البولندية (pl)، البرتغالية (pt)، الرومانية (ro)، الروسية (ru)، الإسبانية (es)، السويدية (sv)، التايلاندية (th)، التركية (tr)

15. جمع الحقول المخصصة

اجمع معلومات إضافية من العملاء أثناء checkout باستخدام الحقول المخصصة:

const session = await client.checkoutSessions.create({
  product_cart: [
    {
      product_id: 'pdt_saas_plan',
      quantity: 1
    }
  ],
  custom_fields: [
    {
      key: 'company_name',
      label: 'Company Name',
      field_type: 'text',
      required: true,
      placeholder: 'Acme Inc.'
    },
    {
      key: 'team_size',
      label: 'Team Size',
      field_type: 'dropdown',
      required: true,
      options: ['1-10', '11-50', '51-200', '201-500', '500+']
    },
    {
      key: 'referral_source',
      label: 'How did you hear about us?',
      field_type: 'dropdown',
      required: false,
      options: ['Google', 'Twitter', 'Friend referral', 'Blog post', 'Other']
    },
    {
      key: 'website',
      label: 'Company Website',
      field_type: 'url',
      required: false,
      placeholder: 'https://example.com'
    }
  ],
  customer: {
    email: 'buyer@company.com',
    name: 'Jane Doe'
  },
  return_url: 'https://yourapp.com/success'
});

تُدرج إجابات الحقول المخصصة تلقائيًا في حمولات webhooks (payment.succeeded وsubscription.active وغيرهما) ويمكن استردادها عبر API. استخدمها لإثراء CRM أو تشغيل تدفقات الإعداد أو تخصيص تجربة العميل.

أنواع الحقول المتاحة: text، number، email، url، date، dropdown، boolean

معاينة جلسات checkout

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

عندما تحتوي السلة على منتج اشتراك، تعيد استجابة المعاينة أيضًا next_billing_date — وهي معاينة لتاريخ الفوترة القادم، حتى تتمكن من عرضه قبل إنشاء الاشتراك. يُحسب نسبيًا إلى الوقت الحالي: now + trial period عند تطبيق تجربة، وإلا now + one payment frequency. يُحذف الحقل من السلال التي تحتوي على منتجات لمرة واحدة فقط. هذا تقدير يستند إلى وقت المعاينة؛ أما next_billing_date المعتمد فيُحدد عند تفعيل الاشتراك.

تعيد المعاينة أيضًا trial_period_days (مدة التجربة الفعلية، المجانية أو المدفوعة) وtrial_amount (رسوم التجربة لكل وحدة بعد الخصومات، بوحدات العملة الصغرى). لا يظهر trial_amount إلا في تجربة مدفوعة، ويكون null في التجربة المجانية أو عند عدم وجود تجربة. استخدم current_breakup للإجمالي الخاضع للضريبة المستحق فعليًا اليوم.

Node.js SDK
Python SDK

const preview = await client.checkoutSessions.preview({
  product_cart: [
    { product_id: 'pdt_123', quantity: 1 }
  ],
  billing_address: {
    country: 'US',
    state: 'CA',
    zipcode: '94102'
  },
  discount_codes: ['SAVE20']
});

console.log('Subtotal:', preview.current_breakup.subtotal);
console.log('Tax:', preview.current_breakup.tax);
console.log('Discount:', preview.current_breakup.discount);
console.log('Total:', preview.current_breakup.total_amount);

// Present only when the cart contains a subscription product
console.log('Next billing date:', preview.next_billing_date);

preview = client.checkout_sessions.preview(
    product_cart=[
        {"product_id": "pdt_123", "quantity": 1}
    ],
    billing_address={
        "country": "US",
        "state": "CA",
        "zipcode": "94102"
    },
    discount_codes=["SAVE20"]
)

print(f"Subtotal: {preview.current_breakup.subtotal}")
print(f"Tax: {preview.current_breakup.tax}")
print(f"Discount: {preview.current_breakup.discount}")
print(f"Total: {preview.current_breakup.total_amount}")

# Present only when the cart contains a subscription product
print(f"Next billing date: {preview.next_billing_date}")

Preview API Reference

عرض وثائق endpoint الكاملة للمعاينة.

الانتقال من الروابط الديناميكية إلى جلسات checkout

الاختلافات الرئيسية

سابقًا، عند إنشاء رابط دفع باستخدام Dynamic Links، كان يُطلب منك توفير عنوان الفوترة الكامل للعميل. مع Checkout Sessions، لم يعد ذلك ضروريًا. يمكنك ببساطة تمرير أي معلومات متاحة لديك، وسنتولى الباقي. على سبيل المثال:

إذا كنت تعرف دولة فوترة العميل فقط، فما عليك سوى توفيرها.
سيجمع تدفق checkout التفاصيل المفقودة تلقائيًا قبل نقل العميل إلى صفحة الدفع.
من ناحية أخرى، إذا كانت لديك جميع المعلومات المطلوبة بالفعل وتريد الانتقال مباشرةً إلى صفحة الدفع، فيمكنك تمرير مجموعة البيانات الكاملة وتضمين confirm=true في نص طلبك.

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

الانتقال من Dynamic Links إلى Checkout Sessions مباشر:

Update your integration

حدّث تكاملك لاستخدام طريقة API أو SDK الجديدة.

Adjust request payload

اضبط حمولة الطلب وفق تنسيق Checkout Sessions.

That's it!

نعم. لا يلزم إجراء إضافي أو خطوات ترحيل خاصة من جانبك.

مرجع API ذي الصلة

Create Checkout Session

مرجع API الكامل لإنشاء جلسات checkout مع جميع parameters والخيارات المتاحة

Preview Checkout Session

مرجع API لمعاينة الأسعار والضرائب والإجماليات قبل إنشاء جلسة

آخر تعديل في ١٧ أغسطس ٢٠٢٦

Integration Guides

Billing Deconstructions

Cookbooks

Quick Start Guide

API Reference & Live Testing

Preview Checkout

المتطلبات الأساسية

إنشاء أول جلسة Checkout

استجابة API

نص الطلب

Required Fields

Optional Fields

الحقول المطلوبة

الحقول الاختيارية

Country Code Reference

أمثلة على الاستخدام

1. Checkout بسيط لمنتج واحد

2. سلة متعددة المنتجات

3. اشتراك مع فترة تجريبية

4. Checkout مؤكد مسبقًا

5. Checkout مع تجاوز العملة

6. طرق الدفع المحفوظة للعملاء العائدين

7. Checkout للأعمال بين الشركات مع جمع المعرّف الضريبي

8. Checkout بالسمة الداكنة مع رموز خصم متسلسلة

9. طرق الدفع الإقليمية (UPI للهند)

10. Checkout باستخدام BNPL (اشترِ الآن وادفع لاحقًا)

11. استخدام طرق الدفع الحالية لإجراء Checkout فوري

12. روابط مختصرة لعناوين URL أوضح للدفع

13. تخطي صفحة نجاح الدفع مع إعادة التوجيه الفورية

14. فرض لغة محددة

15. جمع الحقول المخصصة

معاينة جلسات checkout

Preview API Reference

الانتقال من الروابط الديناميكية إلى جلسات checkout

الاختلافات الرئيسية

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

مرجع API ذي الصلة

Create Checkout Session

Preview Checkout Session

Quick Start Guide

API Reference & Live Testing

Preview Checkout

​المتطلبات الأساسية

​إنشاء أول جلسة Checkout

​استجابة API

​نص الطلب

Required Fields

Optional Fields

​الحقول المطلوبة

​الحقول الاختيارية

Country Code Reference

​أمثلة على الاستخدام

​1. Checkout بسيط لمنتج واحد

​2. سلة متعددة المنتجات

​3. اشتراك مع فترة تجريبية

​4. Checkout مؤكد مسبقًا

​5. Checkout مع تجاوز العملة

​6. طرق الدفع المحفوظة للعملاء العائدين

​7. Checkout للأعمال بين الشركات مع جمع المعرّف الضريبي

​8. Checkout بالسمة الداكنة مع رموز خصم متسلسلة

​9. طرق الدفع الإقليمية (UPI للهند)

​10. Checkout باستخدام BNPL (اشترِ الآن وادفع لاحقًا)

​11. استخدام طرق الدفع الحالية لإجراء Checkout فوري

​12. روابط مختصرة لعناوين URL أوضح للدفع

​13. تخطي صفحة نجاح الدفع مع إعادة التوجيه الفورية

​14. فرض لغة محددة

​15. جمع الحقول المخصصة

​معاينة جلسات checkout

Preview API Reference

​الانتقال من الروابط الديناميكية إلى جلسات checkout

​الاختلافات الرئيسية

​عملية الترحيل

​مرجع API ذي الصلة

Create Checkout Session

Preview Checkout Session

المتطلبات الأساسية

إنشاء أول جلسة Checkout

استجابة API

نص الطلب

الحقول المطلوبة

الحقول الاختيارية

أمثلة على الاستخدام

1. Checkout بسيط لمنتج واحد

2. سلة متعددة المنتجات

3. اشتراك مع فترة تجريبية

4. Checkout مؤكد مسبقًا

5. Checkout مع تجاوز العملة

6. طرق الدفع المحفوظة للعملاء العائدين

7. Checkout للأعمال بين الشركات مع جمع المعرّف الضريبي

8. Checkout بالسمة الداكنة مع رموز خصم متسلسلة

9. طرق الدفع الإقليمية (UPI للهند)

10. Checkout باستخدام BNPL (اشترِ الآن وادفع لاحقًا)

11. استخدام طرق الدفع الحالية لإجراء Checkout فوري

12. روابط مختصرة لعناوين URL أوضح للدفع

13. تخطي صفحة نجاح الدفع مع إعادة التوجيه الفورية

14. فرض لغة محددة

15. جمع الحقول المخصصة

معاينة جلسات checkout

الانتقال من الروابط الديناميكية إلى جلسات checkout

الاختلافات الرئيسية

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

مرجع API ذي الصلة