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

الإيصال

بمجرد أن تصبح المعاملة بالحالة SUCCESS، يشير receiptUrl الخاص بها إلى GET /v3/bills/transactions/{transactionId}/receipt. الاستجابة هي الملف نفسه، وليست غلاف JSON.

curl https://api.oneclickdz.com/v3/bills/transactions/68cdf0a2b7c1e4d5f6a7b8c9/receipt \
  -H "X-Access-Token: YOUR_API_KEY" \
  --output receipt.pdf

الترويسة	القيمة
`Content-Type`	`application/pdf` أو `image/png` أو `image/jpeg`
`Content-Disposition`	`attachment; filename="…"`
`Cache-Control`	`private, max-age=86400`

اقرأ Content-Type لتحديد امتداد الملف. إيصالات Sandbox صور PNG.تحتفظ الأخطاء بغلاف JSON: 404 NOT_FOUND عندما لا تكون المعاملة لك، أو ليست بالحالة SUCCESS، أو لا تملك إيصالًا.خزّن الملف مع operationId وtransactionId. سلّم عميلك الإيصال، لا مجرد رسالة تأكيد.

إشعار الدفع الخاص بـ AADL

بالنسبة إلى معاملات AADL، تُعيد GET /v3/bills/transactions/{transactionId}/avis إشعار avis de paiement الصادر عن مُصدِر الفاتورة بصيغة PDF. يكون متاحًا بمجرد أن يصبح الاكتشاف بالحالة READY، لذا يمكنك عرض الإشعار قبل أن يدفع العميل.

curl https://api.oneclickdz.com/v3/bills/transactions/68cdf0a2b7c1e4d5f6a7b8c9/avis \
  -H "X-Access-Token: YOUR_API_KEY" \
  --output avis.pdf

404 NOT_FOUND لأي مُصدِر فاتورة آخر، أو لمعاملة غير معروفة، أو ما دام الإشعار غير متاح بعد.

السجل

تسرد GET /v3/bills/transactions معاملاتك، الأحدث أولًا، ضمن بيئة مفتاحك فقط.

الاستعلام	الوصف
`status`	حالة واحدة: `PENDING` أو `READY` أو `PROCESSING` أو `UNKNOWN` أو `SUCCESS` أو `FAILED` أو `REFUNDED`
`partner`	اسم شريك واحد
`from`، `to`	حدود ISO 8601 على `createdAt`
`limit`	من 1 إلى 100، والقيمة الافتراضية 20
`offset`	القيمة الافتراضية 0

curl "https://api.oneclickdz.com/v3/bills/transactions?status=SUCCESS&from=2026-09-20T00:00:00Z&to=2026-09-21T00:00:00Z&limit=100" \
  -H "X-Access-Token: YOUR_API_KEY"

يحمل meta القيم total وlimit وoffset لتقسيم الصفحات.

يحمل كل صف الحقول نفسها التي تُعيدها GET /v3/bills/transactions/{transactionId}، بما فيها bills وselectedBills وerror.

المطابقة اليومية

اسرد معاملات الأمس ذات status=SUCCESS، مع التنقّل بين الصفحات باستخدام offset.
طابق كل transactionId مع دفتر حساباتك. قارن total بما حصّلته من عميلك.
اسرد status=REFUNDED وتأكّد من أن كلًّا منها مستردّ من جهتك أيضًا.
اسرد status=UNKNOWN وأبقِها مفتوحة إلى أن تُحسم.

أي SUCCESS غير موجودة لديك هي دفعة قبلتها ولم تسجّلها؛ وأي سجل لديك دون SUCCESS مقابلة هو مبلغ ما كان ينبغي لك تحصيله.

التالي: اختبار Sandbox

إعادة إنتاج كل نتيجة باستخدام حسابات الاختبار

​الإيصال

​إشعار الدفع الخاص بـ AADL

​السجل

​المطابقة اليومية

التالي: اختبار Sandbox

الإيصال

إشعار الدفع الخاص بـ AADL

السجل

المطابقة اليومية