الانتقال إلى المحتوى الرئيسي

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

تتبع فوري

راقب حالة الدفع في الوقت الفعلي

رسوم مرنة

اختر من يدفع رسوم المعاملة

ما ستبنيه

باتباع هذا الدليل، ستُنفّذ سير عمل دفع كامل:
  1. العميل ينشئ طلباً في تطبيقك
  2. نظامك يولّد رابط دفع عبر API Navio
  3. العميل يُكمل الدفع على صفحة الدفع الآمنة
  4. نظامك يتتبع حالة الدفع ويُنفّذ الطلب

المتطلبات المسبقة

1

حساب OneClick

أنشئ حساباً على app.oneclickdz.com
2

التحقق من هوية التاجر

أكمل التحقق على Navio Merchant Info
هذه الخطوة إلزامية قبل إنشاء روابط الدفع
3

مفتاح API

احصل على مفتاح API من لوحة التحكم (استخدم مفتاح Sandbox للاختبار)
4

المتطلبات التقنية

  • خادم backend لمعالجة استدعاءات API - قاعدة بيانات لتخزين الطلبات ومراجع الدفع - فهم أساسي لـ REST APIs

كيف يعمل النظام

  1. العميل يضع طلباً → تحفظه بحالة PENDING
  2. تستدعي /v3/ocpay/createLink → تحصل على paymentUrl وpaymentRef
  3. احفظ paymentRef مع طلبك (مهم!)
  4. وجّه العميل إلى paymentUrl
  5. العميل يدفع → يعود إلى موقعك
  6. تتحقق من الحالة عبر /v3/ocpay/checkPayment/:ref
  7. تُحدّث الطلب وتُنفّذه إذا كانت الحالة CONFIRMED

المفاهيم الأساسية

معرّف فريد لكل دفعة (الصيغة: OCPL-XXXXXX-YYYY). احفظه مع طلبك للتحقق من الحالة لاحقاً.
تنتهي صلاحية الروابط بعد 20 دقيقة. أنشئ رابطاً جديداً إذا احتاج العميل إلى إعادة المحاولة.
تحقق من حالة الدفع عند عودة العميل إلى موقعك أو عند تشغيل مهمة cron كل 20 دقيقة.

هيكل الرسوم

رسوم منخفضة: 0% عند الاحتفاظ بالرصيد في OneClick، فقط 1% عند السحب
يمكنك اختيار من يدفع رسوم السحب:
وضع الرسومالوصفحالة الاستخدام
NO_FEEالتاجر يتحمل جميع الرسومأفضل تجربة للعميل
SPLIT_FEEتقسيم 50/50مسؤولية مشتركة
CUSTOMER_FEEالعميل يدفع جميع الرسومتعظيم أرباحك

خطوات التكامل

اتبع هذه الأدلة بالترتيب:

1. إعداد التاجر

أكمل التحقق من هوية التاجر واحصل على مفتاح API

2. سير الدفع

نفّذ تكامل الدفع الكامل

3. تتبع الحالة

تتبع المدفوعات وحدّث حالة الطلبات

4. أفضل الممارسات

نصائح للإنتاج ومعالجة الأخطاء

بداية سريعة

const fetch = require("node-fetch");

// Create payment link
async function createPayment(orderId, amount, title) {
  const response = await fetch(
    "https://api.oneclickdz.com/v3/ocpay/createLink",
    {
      method: "POST",
      headers: {
        "Content-Type": "application/json",
        "X-Access-Token": process.env.ONECLICK_API_KEY,
      },
      body: JSON.stringify({
        productInfo: { title, amount },
        redirectUrl: `https://yoursite.com/orders/${orderId}`,
      }),
    }
  );

  const data = await response.json();

  // Save paymentRef with your order!
  await db.orders.update(orderId, {
    paymentRef: data.data.paymentRef,
  });

  return data.data.paymentUrl; // Redirect customer here
}

// Check payment status
async function checkPayment(paymentRef) {
  const response = await fetch(
    `https://api.oneclickdz.com/v3/ocpay/checkPayment/${paymentRef}`,
    { headers: { "X-Access-Token": process.env.ONECLICK_API_KEY } }
  );

  const data = await response.json();
  return data.data.status; // PENDING, CONFIRMED, or FAILED
}

الدعم والموارد

مرجع API

توثيق API تفصيلي

التواصل مع الدعم

احصل على مساعدة فريقنا

لوحة التحكم

أدر حسابك

دليل الأمان

حافظ على أمان تكاملك

التالي: إعداد التاجر

هل أنت مستعد للبدء؟ ابدأ بالتحقق من هوية التاجر:

بدء التكامل

أكمل إعداد التاجر والتحقق من هويته