notpanel
الخدماتالأسعارالأسئلة الشائعةهداياAPI
notpanel

متابعون وإعجابات ومشاهدات لكل منصة.

يجمع الكتالوج بين خدمات نديرها مباشرة وسعة من شركاء موثوقين. يظهر التوفر والوقت وrefill وdrip-feed لكل خدمة؛ وتبقى مسارات التنفيذ وهوية الشركاء سرية.

المنتج

  • الخدمات
  • الأسعار
  • مؤشر الأسعار
  • برنامج الشركاء

الموارد

  • API
  • المدونة
  • الأسئلة الشائعة
  • الحالة

الشركة

  • من نحن
  • لماذا NotPanel
  • اتصل بنا

قانوني

  • شروط الخدمة
  • سياسة الخصوصية
  • سياسة الاسترداد

اللغات

  • English
  • Español
  • Português
  • Русский
  • Türkçe
  • العربية
  • हिन्दी
  • Bahasa Indonesia
  • Français
  • 中文

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

support@notpanel.com
notpanel
توثيق الواجهة
+
توثيق الواجهة

مقدمة

  • نظرة عامة
  • البدء
  • المصادقة
  • حدود المعدل
  • الأخطاء

الكتالوج

  • سرد الخدمات
  • الكتالوج المتقدم
  • أنواع الخدمات

الطلبات

  • تقديم طلب
  • حالة الطلب
  • تقدير الاسترداد
  • إعادة التعبئة
  • إلغاء

الحساب

  • حالة الحساب
  • الرصيد

الـ webhooks

  • إدارة الـ webhooks

المرجع

  • سجل التغييرات
  • مجموعات التطوير والمكتبات

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

support@notpanel.com →

حالة الطلب

يعيد الحالة الحالية لطلب واحد أو ما يصل إلى 100 طلب. يمكن أن تقلل webhooks الاستعلام المتكرر، لكنها تُسلّم بأفضل جهد مع إعادة المحاولة؛ وفّق الحالة المهمة باستخدام إجراء status هذا.

POSThttps://notpanel.com/api/v3action=status
مفتاح API مطلوبمحدود بالمعدل (حساب مشترك + IP + إجراء)الجسم: application/x-www-form-urlencoded

المعاملات

الاسمالنوعالوصف
keyمطلوبstringمفتاح API الخاص بك.
actionمطلوبstringيجب أن يكون السلسلة النصية الحرفية "status".
orderstringمعرّف رقمي لطلب واحد. إذا أُرسل كل من order وorders، تكون الأولوية لـ orders.
ordersstring (CSV)ما يصل إلى 100 معرّف رقمي للطلبات مفصولة بفواصل. إذا أُرسل كل من order وorders، تكون الأولوية لـ orders.

مثال على الطلب

استبدل YOUR_API_KEY بالمفتاح المُولَّد ضمن صفحة API في لوحة تحكمك.

curl -X POST https://notpanel.com/api/v3 \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "key=YOUR_API_KEY&action=status&order=7001"
const res = await fetch("https://notpanel.com/api/v3", {
  method: "POST",
  headers: { "Content-Type": "application/x-www-form-urlencoded" },
  body: new URLSearchParams({
    key: "YOUR_API_KEY",
    action: "status",
    order: "7001",
  }),
});

const data = await res.json();
console.log(data);
import requests

res = requests.post(
  "https://notpanel.com/api/v3",
  data={
    "key": "YOUR_API_KEY",
    "action": "status",
    "order": "7001",
},
)
print(res.json())
<?php
$body = http_build_query([
    'key' => 'YOUR_API_KEY',
    'action' => 'status',
    'order' => '7001',
]);

$response = file_get_contents('https://notpanel.com/api/v3', false, stream_context_create([
    'http' => [
        'method'  => 'POST',
        'header'  => "Content-Type: application/x-www-form-urlencoded\r\n",
        'content' => $body,
        'ignore_errors' => true,
    ],
]));

print_r(json_decode($response, true));

مثال على الاستجابة

{
  "status": "In progress",
  "status_key": "in_progress",
  "charge": "0.50",
  "refund": "0.00",
  "refund_pending": 0,
  "refund_pending_amount": "0.00",
  "start_count": "1234",
  "remains": "650",
  "currency": "USD",
  "cancel_available": false,
  "cancel_before": "2026-08-25T10:30:15.000Z",
  "refund_guaranteed_at": "2026-09-01T10:30:00.000Z",
  "refund_policy": "full_if_unresolved_after_7_days"
}

الأخطاء الشائعة

الحالةالجسمالسبب
400{"error":"Missing parameter: order"}لم يُوفَّر order ولا orders.
400{"error":"Order not found"}معرّف الطلب الفردي غير موجود أو لا يخص حسابك.
400{"error":"Maximum 100 orders per request"}احتوى orders بصيغة CSV على أكثر من 100 معرّف. قسّمها إلى دُفعات.

الحقول المالية للطلب العادي

في الطلب العادي، يمثل charge المبلغ المخزن حاليًا وقد يكون المبلغ المحتفظ به أو الصافي بعد تسوية جزئية. يمثل refund رصيد المحفظة الذي تم قيده بالفعل. تعني refund_pending=1 أن مبلغ استرداد مثبتًا ما زال ينتظر مساحة متاحة في المحفظة، ويمثل refund_pending_amount ذلك المبلغ المتبقي. قد يحتفظ الصف الملغى أو المسترد بقيمة charge الأصلية، لذا لا تطرح الحقلين مباشرة. استخدم action=refund_quote واقرأ original_charge وrefunded وrefund_pending_amount وrefundable_now للمطابقة.

استجابة متعددة الحالات

عند توفير orders، تكون الاستجابة كائنًا مفهرسًا بمعرّف الطلب. تُحذف بصمت من النتيجة الطلبات التي لا تخص حسابك — فهي لا تُرجع كأخطاء.

{
  "7001": {
    "status": "Completed",
    "status_key": "completed",
    "charge": "0.50",
    "refund": "0.00",
    "refund_pending": 0,
    "refund_pending_amount": "0.00",
    "start_count": "1234",
    "remains": "0",
    "currency": "USD",
    "cancel_available": false,
    "cancel_before": "2026-08-25T10:30:15.000Z",
    "refund_guaranteed_at": "2026-09-01T10:30:00.000Z",
    "refund_policy": "full_if_unresolved_after_7_days"
  },
  "7002": {
    "status": "Processing",
    "status_key": "cancelling",
    "charge": "10.00",
    "refund": "0.00",
    "start_count": "0",
    "remains": "0",
    "currency": "USD"
  }
}

قيم الحالة

  • pending — مقبول ولم يُرسل بعد. يبقى طلب API العادي في مهلة 15 ثانية يمكن خلالها إلغاؤه مع استرداد كامل.
  • processing — قُبل الطلب وينتظر تأكيد التسليم.
  • in_progress — تم التأكيد، والتسليم جارٍ.
  • completed — سُلِّم بالكامل.
  • partial — سُلِّم جزئيًا؛ قد تكون إعادة التعبئة متاحة.
  • cancelled — أُلغي الطلب وأصبح في حالة نهائية.
  • refunded — مُسترَد (فشل التسليم أو ضمان الطلب غير المحلول بعد سبعة أيام).
  • expired — قيمة نهائية قديمة. الطلبات العادية الحالية التي تبقى في pending أو processing أو in_progress أو parked عند مرور 7 أيام تُرد بالكامل وتظهر كـrefunded.
  • parked — محتجز مؤقتًا قبل الإرسال لأن الخدمة غير متاحة؛ ويمكن إعادة محاولته أو حله لاحقًا.