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

نظرة عامة

يُرجع معاملات دفع الفواتير الخاصة بك، الأحدث أولًا. استخدمه للمطابقة المحاسبية، ولشاشة السجل، وللعثور على معاملة عندما تفقد معرّفها ومرجعها معًا.القائمة محصورة بحسابك أنت وببيئة المفتاح الذي ترسله: مفتاح Sandbox لا يرى أبدًا معاملات الإنتاج، والعكس صحيح.
data هي مصفوفة بسيطة من كائنات المعاملات. أما الأعداد فتوجد في meta: total وlimit وoffset.

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

string
التصفية حسب الحالة. إحدى القيم PENDING، READY، PROCESSING، SUCCESS، FAILED، REFUNDED، UNKNOWN.
string
التصفية حسب مُصدِر الفواتير. إحدى القيم ADE، SONELGAZ، SEAAL، AADL، Algérie Télécom.
string
المعاملات المنشأة في هذه اللحظة أو بعدها فقط. تاريخ أو تاريخ ووقت بتنسيق ISO 8601، مثلًا 2026-08-01 أو 2026-08-01T00:00:00Z.
string
المعاملات المنشأة في هذه اللحظة أو قبلها فقط. بالتنسيق نفسه المستخدم في from.
integer
افتراضي:"20"
حجم الصفحة، بين 1 و100.
integer
افتراضي:"0"
عدد المعاملات المطلوب تخطّيها. صفر أو أكثر.
لا يوجد فلتر ref في هذه الـ endpoint. للعثور على معاملة بمرجعك الخاص، استخدم الحصول على المعاملة بالمرجع.

الاستجابة

boolean
مطلوب
true عند إرجاع الصفحة.
array
مطلوب
مصفوفة من كائنات المعاملات، الأحدث أولًا. لكل عنصر البنية نفسها الموثّقة في الحصول على المعاملة بالمعرّف — بما في ذلك القاعدة القاضية بأن bills وselectedBill وreceiptUrl وoperationId وerror تظهر فقط في الحالات التي تكون فيها ذات معنى.المصفوفة الفارغة تعني أنه لا توجد معاملة مطابقة.
object
مطلوب
string
مطلوب
معرّف الربط، يُرسل أيضًا في ترويسة الاستجابة X-Request-Id.

الأمثلة

استجابة النجاح

استجابات الخطأ

قيمة فلتر غير مقبولة.
الأسباب الشائعة: حالة أو شريك خارج المجموعة المسموح بها، أو from أو to ليس تاريخًا بتنسيق ISO 8601، أو limit أكبر من 100 أو أصغر من 1، أو offset سالب.ما العمل: صحّح سلسلة الاستعلام. القيم حساسة لحالة الأحرف.
المفتاح غائب أو مرفوض.
ما العمل: تحقق من المفتاح عبر التحقق من مفتاح API.
لم نتمكن من التحقق من مفتاحك في الوقت المحدد، أو أن واجهة API في صيانة مُخطط لها.
ما العمل: التزم بترويسة Retry-After (5 ثوانٍ) وأعد المحاولة. تكرار عرض القائمة آمن دائمًا.

التصفح عبر فترة زمنية

meta.total هو العدد الخاص بالفلاتر التي أرسلتها، لذا يمكنك التصفح حتى ترى كل شيء. أبقِ حجم الصفحة معتدلًا والنافذة الزمنية محدودة.
تُنشأ معاملات جديدة أثناء تصفحك. لأغراض المطابقة المحاسبية، حُدّ النافذة الزمنية دائمًا بـ from وto حتى لا تكبر مجموعة النتائج من تحتك.

ما تحتويه القائمة

تظهر هنا عمليات الاكتشاف والدفعات معًا. ويُميّز type بينها:
  • type: "discovery" — بحث لم يُدفع مقابله. حالته PENDING أو READY أو FAILED.
  • type: "payment" — عملية اكتشاف قُدِّمت مقابلها دفعة. حالتها PROCESSING أو SUCCESS أو FAILED أو REFUNDED أو UNKNOWN.
تتحول المعاملة إلى payment في مكانها، محتفظةً بـ transactionId الخاص بها وبمرجعها ref الأصلي.

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

حُدّ كل استعلام

أرسل دائمًا from وto لأغراض المطابقة المحاسبية. القائمة غير المحدودة تكبر مع نمو نشاطك.

طابِق على SUCCESS وREFUNDED

هاتان الحالتان هما موضع تحرك الأموال. أما FAILED فلم تحرّك شيئًا أبدًا.

لا تستعلم دوريًا عن هذه الـ endpoint

لمتابعة معاملة واحدة، استعلم عنها بالمعرّف. تكرار عرض القائمة أبطأ وأثقل على الطرفين.

اقرأ meta.total

هو العدد الخاص بفلاترك، والوسيلة الوحيدة لمعرفة ما إذا كانت هناك صفحة أخرى.

Endpoints ذات الصلة

الحصول على المعاملة بالمعرّف

كائن المعاملة الكامل

الحصول على المعاملة بالمرجع

ابحث بمرجعك ref الخاص

تنزيل الإيصال

إثبات لمعاملة مدفوعة

الإيصالات والمطابقة المحاسبية

روتين مطابقة يومي