4 نقاط نهاية
المعاملات
كل ما دخل وخرج: مدفوعات واستردادات ودفعات نحو البنك ورسوم. مع تفاصيل العملية وخطها الزمني.
عناوين النقاط وأوصافها تأتي من عقد OpenAPI، بالإنجليزية — فلا يمكن أن تحيد عن الواجهة.
بكلمات بسيطة
السجل الوحيد لكل درهم يتحرك — للمتابعة والمطابقة.
متى تستعملونها
لمطابقتكم المحاسبية، أو لشاشة متابعة لدى التاجر، أو للتحقيق في عملية متنازَع عليها.
كيف تدمجونها
- 1اسردوا المعاملات على مدى فترة لمطابقتكم اليومية.
- 2استعملوا تصدير CSV بدل التصفّح متى تجاوز الحجم بضع مئات من الأسطر.
- 3افتحوا الخط الزمني لعملية لتفهموا ما جرى، خطوة بخطوة.
- GET
/v1/transactions/{operationId}/timelineالجدول الزمني للمعاملة - GET
/v1/transactions/{operationId}استرجاع معاملة - GET
/v1/transactions/export.csvتصدير المعاملات (CSV) - GET
/v1/transactionsعرض المعاملات
الجدول الزمني للمعاملة
يُرجع الخط الزمني المُركَّب لدورة حياة معاملة (إنشاء، تفويض، اقتطاع، استرداد، ...).
| الحقل | النوع | الموضع | مطلوب | الوصف |
|---|---|---|---|---|
operationId | integer (int64) | path | مطلوب |
استرجاع معاملة
تجلب معاملة واحدة بواسطة operationId الخاص بها.
| الحقل | النوع | الموضع | مطلوب | الوصف |
|---|---|---|---|---|
operationId | integer (int64) | path | مطلوب |
تصدير المعاملات (CSV)
تبثّ المعاملات المصفّاة على شكل ملف CSV (حتى 10,000 صف). تتطلّب transaction:export.
| الحقل | النوع | الموضع | مطلوب | الوصف |
|---|---|---|---|---|
status | enum | query | اختياري | القيم PENDINGPENDING_3DSSUCCESSFAILEDCANCELED |
type | enum | query | اختياري | القيم PAYMENTREFUNDBILL_PAYMENTBANK_TRANSFER |
method | string | query | اختياري | |
from | string (date-time) | query | اختياري | |
to | string (date-time) | query | اختياري |
عرض المعاملات
يسرد المعاملات الواردة والصادرة لبيئة المفتاح مع عوامل تصفية (الحالة، النوع، الوسيلة، القناة، النطاق الزمني، البحث). الترقيم بالإزاحة (offset) افتراضيًا؛ مرّروا limit (+cursor) للترقيم بالمؤشر (keyset) عند المسح العميق.
| الحقل | النوع | الموضع | مطلوب | الوصف |
|---|---|---|---|---|
status | enum | query | اختياري | القيم PENDINGPENDING_3DSSUCCESSFAILEDCANCELED |
type | enum | query | اختياري | القيم PAYMENTREFUNDBILL_PAYMENTBANK_TRANSFER |
method | string | query | اختياري | |
channel | string | query | اختياري | |
settlementId | string | query | اختياري | |
search | string | query | اختياري | |
from | string (date-time) | query | اختياري | |
to | string (date-time) | query | اختياري | |
cursor | string | query | اختياري | |
limit | integer (int32) | query | اختياري | |
pageable | Pageable | query | مطلوب |
سؤال حول الدمج؟
يجيب فريقنا التقني فرق الإدماج، من أول استدعاء في السندبوكس حتى الانتقال إلى الإنتاج.