getSessions

احصل على قائمة بجلسات الدفع. 🔐 هذه الطريقة تتطلب التفويض.

الوصف

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

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

offset, limit

);

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

المخطط

offset: number
معامل اختياري للتقسيم. الافتراضي: 0
مثال: 0

limit: number
معامل اختياري للتقسيم. الافتراضي: 30
مثال: 30

بشكل افتراضي، يمكنك استرداد 10 كائنات. وذلك بسبب حد السجلات في إعدادات أذونات الوحدة.
لعمل التقسيم بشكل صحيح، تحتاج إلى تكوين أذونات الوحدة وفقًا لاحتياجاتك في القسم المقابل.

أمثلة

مثال بسيط

const response = await Payments.getSessions();

مثال مع السمات

const response = await Payments.getSessions(0, 30);

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

{
  "items": [
    {
      "id": 48,
      "createdDate": "2026-04-10T11:44:56.426Z",
      "updatedDate": "2026-04-10T11:44:56.426Z",
      "type": "session",
      "status": "waiting",
      "paymentAccountId": 1,
      "orderId": 220,
      "amount": null,
      "paymentUrl": null
    },
    {
      "id": 47,
      "createdDate": "2025-11-06T06:42:12.463Z",
      "updatedDate": "2025-11-06T06:42:12.463Z",
      "type": "session",
      "status": "waiting",
      "paymentAccountId": 3,
      "orderId": 205,
      "amount": 50,
      "paymentUrl": "https://checkout.stripe.com/c/pay/cs_test_a19RuP9hh4gGmaSOQwb57OBpnypIifa0FDnGhYe7od5XkRXRUpYXUKDRtm#fidnandhYHdWcXxpYCc%2FJ2FgY2RwaXEnKSd2cXdsdWBEZmZqcGtxJz8nZGZmcVo0VHJuTndEZlZqS2YybGBzJyknZHVsTmB8Jz8ndW5acWB2cVowNEtDcERXRG9vaE89NUZTa2tDan1AdkJNaHN2YnE2Tmw8YE5zVUJCb1ZTYXBkQEBgSXNkZ3JTVj1UbmZDUTVVTXA0cH1CMkZXXDVfUUM0YUJRQTVLTGZPbjU1d0tkcmFoNV8nKSdjd2poVmB3c2B3Jz9xd3BgKSdnZGZuYndqcGthRmppancnPycmY2NjY2NjJyknaWR8anBxUXx1YCc%2FJ3Zsa2JpYFpscWBoJyknYGtkZ2lgVWlkZmBtamlhYHd2Jz9xd3BgeCUl"
    },
    {
      "id": 46,
      "createdDate": "2025-11-05T11:41:05.450Z",
      "updatedDate": "2025-11-06T06:42:12.457Z",
      "type": "session",
      "status": "canceled",
      "paymentAccountId": 3,
      "orderId": 205,
      "amount": 50,
      "paymentUrl": "https://checkout.stripe.com/c/pay/cs_test_a13zyOnaZK22i261vea98XHczmJnyl4e3FuPOtOQRougzYxnkScUQAFmU0#fidnandhYHdWcXxpYCc%2FJ2FgY2RwaXEnKSd2cXdsdWBEZmZqcGtxJz8nZGZmcVo0VHJuTndEZlZqS2YybGBzJyknZHVsTmB8Jz8ndW5acWB2cVowNEtDcERXRG9vaE89NUZTa2tDan1AdkJNaHN2YnE2Tmw8YE5zVUJCb1ZTYXBkQEBgSXNkZ3JTVj1UbmZDUTVVTXA0cH1CMkZXXDVfUUM0YUJRQTVLTGZPbjU1d0tkcmFoNV8nKSdjd2poVmB3c2B3Jz9xd3BgKSdnZGZuYndqcGthRmppancnPycmY2NjY2NjJyknaWR8anBxUXx1YCc%2FJ3Zsa2JpYFpscWBoJyknYGtkZ2lgVWlkZmBtamlhYHd2Jz9xd3BgeCUl"
    },
    "..."
  ],
  "total": 44
}

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

المخطط: ISessionsEntity

total: number
إجمالي عدد السجلات الموجودة.
مثال: 100

items: ISessionEntity[]
مصفوفة من كائنات الجلسة.
مثال:

[
  {
    "id": 27,
    "createdDate": "2025-06-04T04:38:32.849Z",
    "updatedDate": "2025-06-04T04:38:32.849Z",
    "type": "session",
    "status": "waiting",
    "paymentAccountId": 1,
    "orderId": 55,
    "paymentUrl": null
  }
]

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

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

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

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

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

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

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

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

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

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

---