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

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.

OneClickDz Flexy API v3

OneClick هو الموزع الرسمي لـ Algérie Télécom وDjezzy، والمنصة الرقمية الوحيدة في الجزائر التي تجمع تحت سقف واحد: شحن الهاتف، بطاقات الإنترنت، والقسائم الرقمية الدولية (PlayStation، Steam، Xbox، إلخ). تتيح واجهتنا البرمجية للشركات دمج هذه الخدمات مباشرةً في مواقعها أو تطبيقاتها أو أنظمة نقاط البيع - مع توصيل فوري ومدفوعات آمنة. مصممة للمطورين باستجابات موحدة ومعالجة شاملة للأخطاء وتوثيق تفصيلي.

التنقل السريع

دليل البدء السريع

ابدأ في أقل من 5 دقائق

شحن الهاتف

سير عمل شحن الهاتف الكامل

شحن الإنترنت

دليل شحن ADSL و4G

بطاقات الهدايا

سير عمل توصيل المنتجات الرقمية

Navio

تكامل بوابة الدفع

خدماتنا

شحن الهاتف

أرسل شحنات فورية إلى جميع شبكات الهاتف الجزائرية مع تتبع الحالة في الوقت الفعلي. الشبكات المدعومة:
  • Mobilis (مسبق الدفع، لاحق الدفع، ثابت)
  • Djezzy (مسبق الدفع، لاحق الدفع، ثابت)
  • Ooredoo (مسبق الدفع، لاحق الدفع، ثابت)
المميزات:
  • خطط بمبالغ ثابتة وديناميكية
  • شحن فوري أو مجدول
  • استرداد تلقائي عند الفشل
  • تتبع الحالة بمراجع فريدة
عرض مرجع API للهاتف ←

شحن الإنترنت

اشحن خطوط ADSL و4G LTE فوراً مع التحقق من رقم الهاتف. الخدمات:
  • شحن ADSL
  • شحن 4G LTE
  • فئات متعددة من البطاقات
  • توفر المخزون في الوقت الفعلي
المميزات:
  • التحقق من الرقم قبل الشراء
  • شحن فوري باستخدام رقم الهاتف فقط
  • تتبع المعاملات
عرض مرجع API للإنترنت ←

بطاقات الهدايا والمنتجات الرقمية

سلّم بطاقات الهدايا والقسائم الرقمية فوراً مع كتالوج منتجات شامل. الفئات:
  • بطاقات الألعاب (Freefire، Pubg، PSN، Xbox، Steam…)
  • خدمات البث (Shahid…)
  • المحافظ الرقمية (iTunes، Amazon…)
  • بطاقات شحن الهاتف
  • والمزيد…
المميزات:
  • أكثر من 100 منتج متاح
  • فحص المخزون في الوقت الفعلي
  • توصيل رقمي فوري
  • دعم الطلبات بالجملة
عرض مرجع API لبطاقات الهدايا ← اقبل المدفوعات الإلكترونية من عملائك عبر حل بوابة الدفع المتكاملة. طرق الدفع:
  • CIB (بطاقات الائتمان)
  • eDahabia (بطاقة الدفع الوطنية)
المميزات:
  • إنشاء روابط دفع بسيط
  • طرق دفع متعددة في تكامل واحد
  • تتبع حالة الدفع في الوقت الفعلي
  • التحقق التلقائي من المدفوعات
  • معالجة آمنة للمعاملات
  • دعم المبالغ المخصصة
حالات الاستخدام:
  • تكامل الدفع في التجارة الإلكترونية
  • مدفوعات الاشتراكات في الخدمات
  • تحصيل مدفوعات الفواتير
  • التبرعات وجمع التمويل
  • بيع تذاكر الفعاليات
عرض مرجع API لـ Navio ←

لماذا تختار واجهتنا البرمجية؟

استجابات موحّدة

هيكل JSON متسق عبر جميع الـ endpoints مع حقول success وdata وmeta وrequestId

معالجة شاملة للأخطاء

أكواد أخطاء واضحة ورسائل تفصيلية وإرشادات قابلة للتنفيذ لكل سيناريو

تتبع الطلبات

requestId فريد لكل طلب يُتيح تصحيح الأخطاء والدعم بسهولة

أمان الأنواع

التحقق الكامل من المخطط يمنع الطلبات غير الصالحة ويضمن سلامة البيانات

اختبار Sandbox

اختبر جميع الميزات دون التأثير على رصيدك باستخدام وضع sandbox

توثيق تفاعلي

جرّب استدعاءات API مباشرة في التوثيق مع playground المدمج

التسعير ونموذج الأعمال

بسيط وحسب الاستخدام

  • بدون رسوم تكامل — ابدأ التطوير مجاناً
  • بدون اشتراكات شهرية — ادفع فقط ما تستخدمه
  • بدون رسوم خفية — ادفع فقط للمعاملات الناجحة
  • استرداد تلقائي — المعاملات الفاشلة تُسترد فوراً

كيف يعمل نظام الفوترة

  1. رصيد مدفوع مسبقاً: حافظ على رصيد في حساب OneClickDz الخاص بك
  2. خصم تلقائي: المعاملات الناجحة تُخصم من رصيدك
  3. تسعير شفاف: جميع الأسعار بالدينار الجزائري (DZD)

خصومات الأعمال

نقدم أفضل الخصومات للشركات التي تريد إعادة بيع خدماتنا للعملاء النهائيين. هيكل أسعارنا التنافسي مصمم لمساعدتك في بناء أعمال مربحة لخدمات الاتصالات.

استفسر عن أسعار الأعمال

تواصل معنا لمناقشة خصومات الحجم وشراكات الأعمال

البدء

هل أنت مستعد للتكامل؟ اتبع هذه الخطوات البسيطة:
1

إنشاء حساب

سجّل على enterprise.oneclickdz.com للوصول إلى لوحة التحكم
2

إنشاء مفتاح API

فعّل وصول API في الإعدادات وأنشئ مفاتيحك (sandbox + production)
3

الاختبار في Sandbox

استخدم وضع sandbox لاختبار جميع الميزات دون التأثير على رصيدك
4

الانتقال للإنتاج

انتقل إلى مفتاح الإنتاج عندما تكون مستعداً لمعالجة معاملات حقيقية
ابدأ مع دليل البدء السريع ←

تنسيق استجابة API

جميع endpoints الإصدار v3 تُرجع استجابات متسقة وقابلة للتنبؤ:
{
  "success": true,
  "data": {
    "balance": 50000
  },
  "meta": {
    "timestamp": "2025-10-29T00:00:00.000Z"
  },
  "requestId": "req_1234567890_abc123"
}
اعرف المزيد عن تنسيق الاستجابة ←

حالات الاستخدام

ادمج خدمات الاتصالات في متجرك الإلكتروني. دع العملاء يشترون شحن الهاتف وإعادة شحن الإنترنت وبطاقات الهدايا مع منتجاتك.
ابنِ تطبيقات شحن الهاتف لنظامي iOS وAndroid. قدّم شحن متعدد الشبكات مع تتبع في الوقت الفعلي وتوصيل فوري.
أضف خدمات رقمية إلى نقطة البيع. بِع رصيد الهاتف وبطاقات الإنترنت وبطاقات الهدايا في مواقع البيع بالتجزئة.
أنشئ شبكات إعادة البيع مع أنظمة العمولة. تتبع المعاملات وأدِر الأرصدة ووزِّع الأرباح تلقائياً.
ادمج خدمات الاتصالات في تطبيقات البنوك ومنصات الدفع والمحافظ الرقمية لحلول مالية شاملة.
ابنِ أدوات دعم لفرق الـ helpdesk لمساعدة العملاء بسرعة في الشحن وإعادة الشحن أثناء مكالمات الدعم.

موارد المطورين

مرجع API

توثيق كامل للـ endpoints

المصادقة

أمّن وصولك إلى API

معالجة الأخطاء

تعامل مع الأخطاء كالمحترفين

استراتيجيات الاستطلاع

حسِّن فحص الحالة

Webhooks

إشعارات في الوقت الفعلي

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

أنماط جاهزة للإنتاج

هل تحتاج مساعدة؟

دعم البريد الإلكتروني

تواصل مع فريق الدعم على [email protected]

GitHub

تصفح أمثلة الكود والـ SDKs

هل أنت مستعد للبدء؟ توجّه إلى دليل البدء السريع لإرسال أول شحنة في أقل من 5 دقائق.