Skip to main content
GET
قائمة المعاملات

نظرة عامة

يُرجع قائمة مرقّمة بجميع معاملات حسابك، بما فيها الإيداعات والسحوبات والشحنات والمبالغ المستردة والتحويلات.

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

integer
افتراضي:1
رقم الصفحة (الحد الأدنى: 1)
integer
افتراضي:20
العناصر في الصفحة (الحد الأدنى: 1، الحد الأقصى: 100)
string
تاريخ البدء للتصفية (تنسيق ISO 8601: 2025-10-01T00:00:00Z)
string
تاريخ الانتهاء للتصفية (تنسيق ISO 8601: 2025-10-31T23:59:59Z)
عند التصفية حسب التاريخ، يجب توفير معلمتَي from و to معًا.

أنواع المعاملات

دخول الأموال (زيادة)

خروج الأموال (تخفيض)

الاستجابة

boolean
مطلوب
يشير إلى نجاح الطلب
object
مطلوب
object
مطلوب

الأمثلة

مع التصفية بالتاريخ

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

حالات الاستخدام

سجل المعاملات

اعرض سجل المعاملات للمستخدمين في تطبيقك

المحاسبة والتقارير

أنشئ تقارير ومستخرجات مالية

مطابقة الرصيد

تحقق من تغييرات الرصيد وراجع المعاملات

نشاط المستخدم

تتبع أنماط الإنفاق وسلوك المستخدمين

أفضل الممارسات

  • ابدأ بأحجام صفحات معقولة (20 إلى 50 عنصرًا)
  • نفّذ التمرير اللانهائي أو التنقل بين الصفحات
  • خزّن النتائج مؤقتًا لتقليل استدعاءات API
  • استخدم pagination.totalPages لتحديد ما إذا كانت هناك بيانات إضافية
  • قدّم دائمًا معلمتَي from و to معًا - استخدم تنسيق ISO 8601 للتواريخ
  • حدد نطاقات زمنية مناسبة للتقارير - خذ بعين الاعتبار اختلافات المنطقة الزمنية عند التصفية
  • خزّن بيانات المعاملات محليًا إذا أمكن - استخدم فلاتر التاريخ للحد من مجموعات النتائج
  • نفّذ واجهة مستخدم مناسبة للتصفح بالصفحات - فكّر في إشعارات webhook للتحديثات الفورية
  • اعرض نوع المعاملة بلغة سهلة للمستخدم
  • اعرض المبالغ بتنسيق العملة المناسب
  • أدرج الطوابع الزمنية بالمنطقة الزمنية المحلية
  • ربط المعاملات بالكائنات المرتبطة (الشحنات، الطلبات)

Endpoints ذات الصلة

الحصول على الرصيد

التحقق من رصيد الحساب الحالي