انتقل إلى المحتوى الرئيسي

createSession

إنشاء جلسة دفع. 🔐 تتطلب هذه الطريقة .

الوصف​

تقوم هذه الطريقة بإنشاء جلسة دفع. تعيد Promise التي تحل إلى كائن جلسة الدفع ICreateSessionEntity.

.createSession(

, ,

);

مخطط المعلمات​

المخطط

orderId(مطلوب): number
معرف الطلب
مثال: 12345

type(مطلوب): 'session' | 'intent'
نوع الجلسة. القيم الممكنة: "session" أو "intent"
مثال: 'session'

automaticTaxEnabled: boolean
الحساب التلقائي لمعدل الضريبة. الافتراضي: false
مثال: false

أمثلة​

مثال بسيط​

const response = await Payments.createSession(1, 'session');

مثال على الاستجابة​

{
  "id": 58,
  "createdDate": "2026-10-08T10:11:50.084Z",
  "updatedDate": "2026-10-08T10:11:50.084Z",
  "type": "session",
  "status": "waiting",
  "paymentAccountId": 1,
  "orderId": 685,
  "amount": null,
  "paymentUrl": null
}

مخطط الاستجابة​

المخطط: ICreateSessionEntity

id: number
معرف الكائن.
مثال: 1764

createdDate: string
تاريخ إنشاء الكائن.
مثال: "2025-02-26T10:13:16.839Z"

updatedDate: string
تاريخ تعديل الكائن.
مثال: "2025-02-26T10:13:16.839Z"

type: 'session' | 'intent'
يمكن أن يكون النوع 'session' أو 'intent'.
مثال: "session"

status: string
حالة الدفع.
مثال: "completed"

paymentAccountId: number
معرف حساب الدفع.
مثال: 1

orderId: number
معرف الطلب.
مثال: 1

paymentUrl: string | null
رابط الدفع.
مثال: " https://www.sandbox.paypal.com/checkoutnow?token=9BE88048TU058770M"

amount: number | null
مبلغ جلسة الدفع.
مثال: 100

clientSecret: string
مفتاح السر الخاص بالعميل الذي يتم إرجاعه من قبل مزود الدفع (مثل Stripe) عند إنشاء جلسة.
مثال: "pi_3MtwBwLkdIwHu7ix28a3tqPa_secret_YrKJUKribcBjcG8HVhfZluoGH"

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

خطوات تفصيلية في الوثائق:

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

جربها مباشرة​

قم بتشغيل هذه الطريقة بشكل تفاعلي في صندوق أدوات JS SDK — قم بتوصيل عنوان مشروعك ورمز التطبيق عند الزيارة الأولى، ثم افتح:

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