ما الذي تقدّمه
تتيح خدمة دفع الفواتير لتطبيقك دفع الفواتير الجزائرية نيابةً عن عملائك. ترسل معرّف الحساب الخاص بالعميل، فتُعيد الواجهة الفواتير غير المدفوعة، ثم تدفع واحدة منها أو أكثر، وتنزّل الإيصال.يدعم النظام ستة مُصدِري فواتير:ADE وSONELGAZ وSEAAL وAADL وSEOR وAlgérie Télécom.عنوان URL الأساسي:
https://api.oneclickdz.com. يحمل كل طلب المفتاح الخاص بك في الترويسة X-Access-Token. يستخدم مفتاح Sandbox ومفتاح الإنتاج عنوان URL نفسه والمسارات نفسها؛ والمفتاح هو الذي يحدّد البيئة.مسار العملية
1
الاكتشاف
POST /v3/bills/discover مع الشريك ومعرّف الحساب وref الخاص بك. تتضمّن الاستجابة transactionId.
→ اكتشاف الفواتير2
قراءة الفواتير
استطلع حالة
GET /v3/bills/transactions/{id} إلى أن تصبح قيمة status هي READY. تحمل المعاملة حينئذٍ bills[]، ولكلّ فاتورة amount وfee.3
الدفع
POST /v3/bills/pay مع transactionId وbillId واحد (أو عدة billIds) وref جديد.
→ دفع الفواتير4
التأكيد وتنزيل الإيصال
استطلع الحالة إلى أن تصبح قيمة
status هي SUCCESS أو FAILED أو REFUNDED، ثم نزّل الإيصال.
→ حالة المعاملة · الإيصالاتقاعدتان
الحالات
الرسوم
نقاط النهاية
الأدلة
1. الشركاء والحسابات
الكائن
account الدقيق لكل مُصدِر فاتورة2. اكتشاف الفواتير
بدء عملية اكتشاف وقراءة الفواتير
3. دفع الفواتير
دفع فاتورة واحدة أو عدة فواتير في طلب واحد
4. حالة المعاملة
كل حالة، وكل حقل، وطريقة استطلاع الحالة
5. الإيصالات والمطابقة
الإيصالات وإشعارات AADL والسجل
6. اختبار Sandbox
حسابات اختبار لكل نتيجة