قائمة المعاملات
دفع الفواتير
قائمة المعاملات
تصفّح عمليات اكتشاف الفواتير والدفعات الخاصة بك صفحةً صفحة
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"
عدد المعاملات المطلوب تخطّيها. صفر أو أكثر.
الاستجابة
boolean
مطلوب
true عند إرجاع الصفحة.array
مطلوب
مصفوفة من كائنات المعاملات، الأحدث أولًا. لكل عنصر البنية نفسها الموثّقة في الحصول على المعاملة بالمعرّف — بما في ذلك القاعدة القاضية بأن
bills وselectedBill وreceiptUrl وoperationId وerror تظهر فقط في الحالات التي تكون فيها ذات معنى.المصفوفة الفارغة تعني أنه لا توجد معاملة مطابقة.object
مطلوب
string
مطلوب
معرّف الربط، يُرسل أيضًا في ترويسة الاستجابة
X-Request-Id.الأمثلة
استجابة النجاح
استجابات الخطأ
400 — خطأ في التحقق
400 — خطأ في التحقق
قيمة فلتر غير مقبولة.الأسباب الشائعة: حالة أو شريك خارج المجموعة المسموح بها، أو
from أو to ليس تاريخًا بتنسيق ISO 8601، أو limit أكبر من 100 أو أصغر من 1، أو offset سالب.ما العمل: صحّح سلسلة الاستعلام. القيم حساسة لحالة الأحرف.401 — رمز وصول مفقود أو غير صالح
401 — رمز وصول مفقود أو غير صالح
503 — المصادقة أو الخدمة غير متاحة
503 — المصادقة أو الخدمة غير متاحة
لم نتمكن من التحقق من مفتاحك في الوقت المحدد، أو أن واجهة 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 الخاصتنزيل الإيصال
إثبات لمعاملة مدفوعة
الإيصالات والمطابقة المحاسبية
روتين مطابقة يومي

