## مرحباً بك في Navio يُمكّنك OneClick Payment (Navio) من قبول المدفوعات الإلكترونية الآمنة في الجزائر بأقل جهد للتكامل. أنشئ روابط دفع، تتبع المعاملات، وأدر أموالك - كل ذلك عبر API بسيطة. ابدأ في دقائق مع API سهل الاستخدام أمان بمستوى البنوك مدعوم من SATIM راقب حالة الدفع في الوقت الفعلي اختر من يدفع رسوم المعاملة ## ما ستبنيه باتباع هذا الدليل، ستُنفّذ سير عمل دفع كامل: 1. **العميل ينشئ طلباً** في تطبيقك 2. **نظامك يولّد رابط دفع** عبر API Navio 3. **العميل يُكمل الدفع** على صفحة الدفع الآمنة 4. **نظامك يتتبع حالة الدفع** ويُنفّذ الطلب ## المتطلبات المسبقة أنشئ حساباً على [app.oneclickdz.com](https://enterprise.oneclickdz.com/) أكمل التحقق على [Navio Merchant Info](https://enterprise.oneclickdz.com/profile) هذه الخطوة **إلزامية** قبل إنشاء روابط الدفع احصل على مفتاح API من لوحة التحكم (استخدم مفتاح Sandbox للاختبار) * خادم 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` | العميل يدفع جميع الرسوم | تعظيم أرباحك | ## خطوات التكامل اتبع هذه الأدلة بالترتيب: أكمل التحقق من هوية التاجر واحصل على مفتاح API نفّذ تكامل الدفع الكامل تتبع المدفوعات وحدّث حالة الطلبات نصائح للإنتاج ومعالجة الأخطاء ## بداية سريعة ```javascript Node.js theme={null} 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 } ``` ```python Python theme={null} import requests import os # Create payment link def create_payment(order_id, amount, title): response = requests.post( 'https://api.oneclickdz.com/v3/ocpay/createLink', headers={ 'Content-Type': 'application/json', 'X-Access-Token': os.getenv('ONECLICK_API_KEY') }, json={ 'productInfo': {'title': title, 'amount': amount}, 'redirectUrl': f'https://yoursite.com/orders/{order_id}' } ) data = response.json() # Save paymentRef with your order! db.orders.update(order_id, { 'paymentRef': data['data']['paymentRef'] }) return data['data']['paymentUrl'] # Redirect customer here # Check payment status def check_payment(payment_ref): response = requests.get( f'https://api.oneclickdz.com/v3/ocpay/checkPayment/{payment_ref}', headers={'X-Access-Token': os.getenv('ONECLICK_API_KEY')} ) data = response.json() return data['data']['status'] # PENDING, CONFIRMED, or FAILED ``` ```php PHP theme={null} ['title' => $title, 'amount' => $amount], 'redirectUrl' => "https://yoursite.com/orders/$orderId" ])); $response = curl_exec($ch); $data = json_decode($response, true); // Save paymentRef with your order! $db->orders->update($orderId, [ 'paymentRef' => $data['data']['paymentRef'] ]); return $data['data']['paymentUrl']; // Redirect customer here } // Check payment status function checkPayment($paymentRef) { $ch = curl_init("https://api.oneclickdz.com/v3/ocpay/checkPayment/$paymentRef"); curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); curl_setopt($ch, CURLOPT_HTTPHEADER, [ 'X-Access-Token: ' . getenv('ONECLICK_API_KEY') ]); $response = curl_exec($ch); $data = json_decode($response, true); return $data['data']['status']; // PENDING, CONFIRMED, or FAILED } ?> ``` ## الدعم والموارد توثيق API تفصيلي احصل على مساعدة فريقنا أدر حسابك حافظ على أمان تكاملك ## التالي: إعداد التاجر هل أنت مستعد للبدء؟ ابدأ بالتحقق من هوية التاجر: أكمل إعداد التاجر والتحقق من هويته