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

ابنِ مع واجهات برمجة تطبيقات وان كليك

قم بدمج شحن الرصيد، باقات الإنترنت، المنتجات الرقمية، والمدفوعات الآمنة في تطبيقك باستخدام واجهات برمجة تطبيقات REST بسيطة.

APIs من نوع RESTful
تتبع في الوقت الفعلي
بنية تحتية آمنة
بيئة اختبار (Sandbox)
JavaScriptPHPPython
import { OCPay } from '@ocpay/node';
const client = new OCPay('sk_live_...');
await client.charges.create({
amount: 1500,
currency: 'DZD'
});
$ocpay = new \OCPay\Client('sk_live_...');
$ocpay->charges->create([
'amount' => 1500,
'currency' => 'DZD'
]);
import ocpay
ocpay.api_key = 'sk_live_...'
ocpay.Charge.create(
amount=1500,
currency='DZD'
)
200 OK — Response
{
  "id": "ch_9x3a",
  "status": "success",
  "amount": 1500,
  "created": 1680000000
}
التوثيق

استكشف مواردنا

كل ما تحتاجه لبناء وتطوير تكاملك البرمجي.

بداية سريعة

ابدأ العمل في غضون دقائق.

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

أدلة التكامل

دروس خطوة بخطوة لكل منصة.

فتح التوثيق
أدلة التكامل

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

تعلم كيفية البناء من أجل التوسع والموثوقية.

فتح التوثيق
أفضل الممارسات

أمثلة وكود

مقتطفات برمجية جاهزة وتطبيقات تجريبية.

فتح التوثيق
أمثلة وكود
واجهات البرمجة (APIs)

منتجات API المتاحة

تصفح الكتالوج الكامل لواجهات برمجة تطبيقات وان كليك. تتبع كل واجهة نفس نمط المصداقية والاستجابة غير المتزامنة.

API شحن الرصيد

شحن رصيد أي متعامل جزائري: جازي، أوريدو، موبيليس.

المميزات

الاستعلام عن الخطط المتاحة، إرسال الشحن، والتحقق من حالة المعاملة باستخدام مرجع فريد.

أمثلة لنقاط النهاية

GET/v3/mobile/plans
POST/v3/mobile/send
GET/v3/mobile/check-ref/:ref

API مدفوعات Navio

إنشاء روابط دفع آمنة وقبول مدفوعات بالدينار الجزائري عبر CIB/الذهبية.

المميزات

إنشاء روابط دفع بمرجع فريد، توجيه العملاء، والتحقق من حالة الدفع.

أمثلة لنقاط النهاية

POST/v3/ocpay/createLink
GET/v3/ocpay/checkPayment/:ref

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

توزيع بطاقات الهدايا الرقمية من علامات تجارية محلية وعالمية.

المميزات

جلب الكتالوج الكامل، تقديم الطلبات، والتحقق من تسليم الطلب بواسطة المعرف.

أمثلة لنقاط النهاية

GET/v3/gift-cards/catalog
POST/v3/gift-cards/placeOrder
GET/v3/gift-cards/checkOrder/:id

API شحن الإنترنت

بيع باقات الإنترنت وأحجام البيانات لجميع المتعاملين.

المميزات

تصفح كتالوجات المنتجات، إرسال الشحن، وتتبع حالة التسليم باستخدام معرف فريد.

أمثلة لنقاط النهاية

GET/v3/internet/products
POST/v3/internet/send
GET/v3/internet/check-id/:id
Webhooks

إشعارات الأحداث الفورية

ابقَ على اطلاع بالأحداث غير المتزامنة تلقائياً.

معالجة فورية

تلقي تحديثات فورية عند تغير حالة الطلب.

إعادة محاولة تلقائية

إدارة مدمجة لإخفاقات تسليم Webhooks.

التحقق من الأمان

التحقق من صحة Webhook باستخدام ترويسات التوقيع.

async function pollStatus(checkFunction, options = {}) {
const {
maxAttempts = 60,
interval = 5000,
finalStates = ["FULFILLED", "REFUNDED"],
} = options;
for (let attempt = 1; attempt <= maxAttempts; attempt++) {
const result = await checkFunction();
if (finalStates.includes(result.status)) {
return result;
}
if (attempt < maxAttempts) {
await new Promise((resolve) => setTimeout(resolve, interval));
}
}
throw new Error("Polling timeout");
}
// Usage
const result = await pollStatus(() => checkTopupStatus(topupId), {
maxAttempts: 60,
interval: 5000,
});
بيئة الاختبار (Sandbox)

اختبر قبل الإطلاق الفعلي

توفر وان كليك بيئة اختبار كاملة حيث يمكنك محاكاة المعاملات بأمان قبل النشر في الإنتاج.

الاختبار بدون أموال حقيقية
محاكاة النجاح أو الفشل
استجابات API فورية
بيئة تطوير آمنة

استخدم أرقام الهاتف التجريبية هذه عند الاتصال بـ API شحن الرصيد في وضع الاختبار.

ارقام-الاختبار.txt
وضع Sandbox
0600000001
السيناريوسيناريو الاسترجاع
0600000002
السيناريوالعروض المقترحة
0600000003
السيناريوخطأ غير معروف

نصيحة للمحترفين:تستخدم طلبات Sandbox نفس نقاط النهاية. قم بضبط sandbox: true في جسم الطلب.

Logo

شريكك الموثوق للتحول الرقمي وحلول المؤسسات.

© 2026 وان كليك. جميع الحقوق محفوظة.