الانتقال إلى المحتوى الرئيسي
POST
/
v3
/
ocpay
/
createLink
curl --request POST \
  --url https://api.oneclickdz.com/v3/ocpay/createLink \
  --header 'Content-Type: application/json' \
  --header 'X-Access-Token: YOUR_API_KEY' \
  --data '{
  "productInfo": {
    "title": "Premium Subscription",
    "description": "Monthly access to premium features",
    "amount": 5000
  },
  "feeMode": "NO_FEE",
  "successMessage": "Thank you for your purchase!",
  "redirectUrl": "https://yourstore.com/success?orderId=12345"
}'

​
نظرة عامة

أنشئ رابط دفع آمن للاستخدام مرة واحدة مع إعدادات قابلة للتخصيص. مثالي لطلبات التجارة الإلكترونية ومدفوعات الخدمات وتجديدات الاشتراكات.
التحقق من صحة التاجر مطلوب: أكمل التحقق من صحة التاجر على https://app.oneclickdz.com/profile قبل استخدام هذا الـ endpoint.

​
جسم الطلب

​
productInfo
object
مطلوب
تفاصيل المنتج أو الخدمة المدفوع مقابلها
​
feeMode
string
افتراضي:"NO_FEE"
يحدد من يدفع رسوم السحب - NO_FEE - التاجر يدفع جميع الرسوم (الافتراضي) - SPLIT_FEE - الرسوم مقسَّمة 50/50 - CUSTOMER_FEE - العميل يدفع جميع الرسوم
​
successMessage
string
رسالة نجاح مخصصة (بحد أقصى 500 حرف) تُعرض بعد الدفع
​
redirectUrl
string
URL إعادة التوجيه بعد الدفع الناجح (يجب أن يكون HTTP/HTTPS صالحاً)

​
الاستجابة

​
success
boolean
يشير إلى نجاح العملية
​
data
object
تفاصيل رابط الدفع
​
meta
object
بيانات وصفية للاستجابة

​
الميزات الرئيسية

مرونة الرسوم

اختر من يدفع رسوم المعاملة - التاجر أو العميل أو مشتركَين

علامة تجارية مخصصة

رسائل نجاح مخصصة وURL إعادة توجيه

اختبار sandbox

اختبر تكاملك بأمان قبل الإطلاق

أمان الاستخدام الفردي

كل رابط للاستخدام مرة واحدة لأمان معزَّز

​
ملاحظات مهمة

حدود المبلغ: - الحد الأدنى: 500 دج - الحد الأقصى: 500,000 دج - يجب أن يكون عدداً صحيحاً (بدون كسور عشرية)
بنية الرسوم: - 0% عند استخدام رصيد OneClick - 1% رسوم سحب فقط (قابلة للتكوين لكل معاملة)
انتهاء صلاحية الرابط: تنتهي صلاحية روابط الدفع بعد 20 دقيقة من الإنشاء إذا لم يُبدأ الدفع
curl --request POST \
  --url https://api.oneclickdz.com/v3/ocpay/createLink \
  --header 'Content-Type: application/json' \
  --header 'X-Access-Token: YOUR_API_KEY' \
  --data '{
  "productInfo": {
    "title": "Premium Subscription",
    "description": "Monthly access to premium features",
    "amount": 5000
  },
  "feeMode": "NO_FEE",
  "successMessage": "Thank you for your purchase!",
  "redirectUrl": "https://yourstore.com/success?orderId=12345"
}'

{
  "success": true,
  "data": {
    "paymentLink": {
      "uid": "user_123456789",
      "ref": "OCPL-A1B2C3-D4E5",
      "isSandbox": false,
      "productInfo": {
        "title": "Premium Subscription",
        "description": "Monthly access to premium features",
        "amount": 5000
      },
      "feeMode": "NO_FEE",
      "successMessage": "Thank you for your purchase!",
      "redirectUrl": "https://yourstore.com/success?orderId=12345",
      "time": "2025-01-15T10:30:00Z"
    },
    "paymentUrl": "https://pay.ocdz.link/pay/OCPL-A1B2C3-D4E5",
    "paymentRef": "OCPL-A1B2C3-D4E5"
  },
  "meta": {
    "timestamp": "2025-01-15T10:30:00Z",
    "requestId": "req_abc123xyz"
  }
}

​
الخطوات التالية

التحقق من حالة الدفع

تعلم كيفية التحقق من حالة الدفع

دليل التكامل

دليل تكامل Navio الكامل