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 →

Cancel an order

يلغي طلبًا عاديًا واحدًا أو دفعة متتابعة من ما يصل إلى 100 معرّف يخص الحساب. لا يكون كل طلب عادي عبر API مؤهلاً إلا خلال نافذة السماح الخاصة به، ومدتها 15 ثانية قبل الإرسال.

POSThttps://notpanel.com/api/v3action=cancel
مفتاح API مطلوبمحدود بالمعدل (حساب مشترك + IP + إجراء)الجسم: application/x-www-form-urlencoded
قدّم معرّف order رقميًا واحدًا أو معرّفات orders مفصولة بفواصل، حتى 100. لا يمدد وضع الدفعات نافذة إلغاء أي طلب مطلقًا.

المعاملات

الاسمالنوعالوصف
keyمطلوبstringمفتاح API الخاص بك.
actionمطلوبstringيجب أن يكون السلسلة النصية الحرفية "cancel".
orderمشروطstringمعرّف رقمي لطلب عادي واحد يخص الحساب ويعيده action=add.
ordersمشروطstring (CSV)معرّفات طلبات عادية مفصولة بفواصل، بحد أقصى 100. تحافظ الاستجابة على ترتيب الإدخال وتعيد نتيجة نجاح أو خطأ لكل عنصر.

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

استبدل 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=cancel&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: "cancel",
    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": "cancel",
    "order": "7001",
},
)
print(res.json())
<?php
$body = http_build_query([
    'key' => 'YOUR_API_KEY',
    'action' => 'cancel',
    '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));

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

{
  "order": 7001,
  "status": "Canceled",
  "status_key": "cancelled",
  "cancel": 1,
  "refund": "0.50",
  "refund_pending": 0
}

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

الحالةالجسمالسبب
409{"error":"Cancellation window has ended or the order has already started"}غادر الطلب العادي مهلة الإلغاء البالغة 15 ثانية أو لم يعد في pending. يعيد الطلب الفردي 409.
409{"error":"Order is already completed"}العنصر في حالة نهائية لا تقبل الإلغاء. أما إعادة محاولة إلغاء سابق ناجح فتعيد النتيجة الناجحة نفسها.
409{"error":"Order is already refunded"}العنصر في حالة نهائية لا تقبل الإلغاء. أما إعادة محاولة إلغاء سابق ناجح فتعيد النتيجة الناجحة نفسها.
404{"error":"Order not found"}لا يوجد طلب عادي بهذا المعرّف يخص هذا الحساب. يعيد الطلب الفردي 404.
429{"error":"Rate limit exceeded for cancel"}تم بلوغ حد إجراء الإلغاء. أعد المحاولة بعد التأخير المُبلغ عنه؛ رمز الاستجابة 429.

الإلغاء الجماعي

استخدم orders=7001,7002. تُعالج المعرّفات بالتتابع، ويجتاز كل طلب عادي فحوص الملكية والحالة pending ونافذة 15 ثانية نفسها المستخدمة في الإلغاء الفردي.

[
  {
    "order": 7001,
    "status": "Canceled",
    "status_key": "cancelled",
    "cancel": 1,
    "refund": "0.50",
    "refund_pending": 0
  },
  {
    "order": 7002,
    "error": "Cancellation window has ended or the order has already started"
  }
]

نتائج الإلغاء والمبالغ المستردة

يُحتجز طلب API العادي 15 ثانية قبل الإرسال. إلغاؤه وهو لا يزال pending يغلق الطلب ذريًا ويثبت استردادًا كاملًا. يمثل refund المبلغ الذي تم قيده بالفعل في المحفظة؛ وإذا منعت سعة المحفظة القيد مؤقتًا تكون refund_pending=1. إعادة الإلغاء تعيد النتيجة نفسها من دون تكرار المال.