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 →

قراءة تقدير الاسترداد

يعيد لقطة تسوية استرداد للقراءة فقط لطلب واحد ذي معرّف رقمي يخص الحساب.

POSThttps://notpanel.com/api/v3action=refund_quote
مفتاح API مطلوبمحدود بالمعدل (حساب مشترك + IP + إجراء)الجسم: application/x-www-form-urlencoded
لا يلغي action=refund_quote عنصرًا ولا يغير المحفظة. استخدمه لفهم مبالغ الخصم والاسترداد قبل اختيار إجراء موثق آخر.

المعاملات

الاسمالنوعالوصف
keyمطلوبstringمفتاح API الخاص بك.
actionمطلوبstringيجب أن تكون القيمة الحرفية "refund_quote".
orderمطلوبstringOne account-owned numeric order ID.

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

استبدل 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=refund_quote&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: "refund_quote",
    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": "refund_quote",
    "order": "7001",
},
)
print(res.json())
<?php
$body = http_build_query([
    'key' => 'YOUR_API_KEY',
    'action' => 'refund_quote',
    '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,
  "kind": "order",
  "status": "In progress",
  "status_key": "in_progress",
  "currency": "USD",
  "original_charge": "0.50",
  "refunded": "0.00",
  "refund_pending": 0,
  "refund_pending_amount": "0.00",
  "refundable_now": "0.00",
  "cancel_available": false,
  "cancel_before": "2026-08-25T10:30:15.000Z",
  "unresolved_refund_guaranteed_at": "2026-09-01T10:30:00.000Z",
  "unresolved_refund_amount": "0.50",
  "partial_refund_calculation": "confirmed_refund_ratio"
}

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

الحالةالجسمالسبب
400{"error":"Missing parameter: order"}حُذف معامل order المطلوب. الاستجابة 400.
404{"error":"Order not found"}لا يوجد طلب مطابق يخص هذا الحساب. تكون الاستجابة 404.

الطلبات العادية

يمثل original_charge الخصم الأصلي ويمثل refunded الرصيد الذي تم قيده بالفعل. تعني refund_pending=1 أن مبلغ استرداد مثبتًا ينتظر مساحة في المحفظة، ويمثل refund_pending_amount المبلغ المتبقي الذي لم يدخل بعد في refunded. قبل النتيجة النهائية، يعرض refundable_now الاستحقاق المتاح ضمن نافذة 15 ثانية أو ضمان 7 أيام الثابت. بعد التسوية الجزئية أو الملغاة أو المستردة تكون قيمة refundable_now صفرًا؛ ولا تعني رصيدًا إضافيًا موعودًا. يعرض التقدير أيضًا المواعيد وتسوية الاسترداد الجزئي المؤكدة. قد يكون charge في status مبلغًا محتفظًا به أو صافيًا، لذا استخدم حقول القراءة فقط بدل طرح قيم status.