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

createSession

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

الوصف

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

المدفوعات.createSession(

orderId*, type*, automaticTaxEnabled

);

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

المخطط

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

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

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

أمثلة

مثال بسيط

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

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

{
"id": 1764,
"type": "session",
"status": "completed",
"orderId": 1,
"paymentAccountId": 1,
"paymentUrl": "https://checkout.stripe.com/c/pay/cs_test_...nP3F3cGB4JSUl",
"createdDate": "2026-02-06T03:16:19.337Z",
"updatedDate": "2026-02-06T05:15:24.932Z",
"amount": 4061.55,
"clientSecret": "pi_3Mtw...ZluoGH"
}

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

المخطط: 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"