Documentation Index
Fetch the complete documentation index at: https://docs.oneclickdz.com/llms.txt
Use this file to discover all available pages before exploring further.
مرحباً بك في Navio
يُمكّنك OneClick Payment (Navio) من قبول المدفوعات الإلكترونية الآمنة في الجزائر بأقل جهد للتكامل. أنشئ روابط دفع، تتبع المعاملات، وأدر أموالك - كل ذلك عبر API بسيطة.إعداد سريع
ابدأ في دقائق مع API سهل الاستخدام
مدفوعات آمنة
أمان بمستوى البنوك مدعوم من SATIM
تتبع فوري
راقب حالة الدفع في الوقت الفعلي
رسوم مرنة
اختر من يدفع رسوم المعاملة
ما ستبنيه
باتباع هذا الدليل، ستُنفّذ سير عمل دفع كامل:- العميل ينشئ طلباً في تطبيقك
- نظامك يولّد رابط دفع عبر API Navio
- العميل يُكمل الدفع على صفحة الدفع الآمنة
- نظامك يتتبع حالة الدفع ويُنفّذ الطلب
المتطلبات المسبقة
حساب OneClick
أنشئ حساباً على app.oneclickdz.com
التحقق من هوية التاجر
أكمل التحقق على Navio Merchant
Info
كيف يعمل النظام
- العميل يضع طلباً → تحفظه بحالة
PENDING - تستدعي
/v3/ocpay/createLink→ تحصل علىpaymentUrlوpaymentRef - احفظ
paymentRefمع طلبك (مهم!) - وجّه العميل إلى
paymentUrl - العميل يدفع → يعود إلى موقعك
- تتحقق من الحالة عبر
/v3/ocpay/checkPayment/:ref - تُحدّث الطلب وتُنفّذه إذا كانت الحالة
CONFIRMED
المفاهيم الأساسية
مرجع الدفع (paymentRef)
مرجع الدفع (paymentRef)
معرّف فريد لكل دفعة (الصيغة:
OCPL-XXXXXX-YYYY). احفظه مع طلبك للتحقق من الحالة لاحقاً.انتهاء صلاحية رابط الدفع
انتهاء صلاحية رابط الدفع
تنتهي صلاحية الروابط بعد 20 دقيقة. أنشئ رابطاً جديداً إذا احتاج العميل إلى إعادة المحاولة.
التحقق من الحالة
التحقق من الحالة
تحقق من حالة الدفع عند عودة العميل إلى موقعك أو عند تشغيل مهمة cron كل 20 دقيقة.
هيكل الرسوم
رسوم منخفضة: 0% عند الاحتفاظ بالرصيد في OneClick، فقط 1% عند السحب
| وضع الرسوم | الوصف | حالة الاستخدام |
|---|---|---|
NO_FEE | التاجر يتحمل جميع الرسوم | أفضل تجربة للعميل |
SPLIT_FEE | تقسيم 50/50 | مسؤولية مشتركة |
CUSTOMER_FEE | العميل يدفع جميع الرسوم | تعظيم أرباحك |
خطوات التكامل
اتبع هذه الأدلة بالترتيب:1. إعداد التاجر
أكمل التحقق من هوية التاجر واحصل على مفتاح API
2. سير الدفع
نفّذ تكامل الدفع الكامل
3. تتبع الحالة
تتبع المدفوعات وحدّث حالة الطلبات
4. أفضل الممارسات
نصائح للإنتاج ومعالجة الأخطاء
بداية سريعة
الدعم والموارد
مرجع API
توثيق API تفصيلي
التواصل مع الدعم
احصل على مساعدة فريقنا
لوحة التحكم
أدر حسابك
دليل الأمان
حافظ على أمان تكاملك
التالي: إعداد التاجر
هل أنت مستعد للبدء؟ ابدأ بالتحقق من هوية التاجر:بدء التكامل
أكمل إعداد التاجر والتحقق من هويته

