قراءة تقدير الاسترداد
يعيد لقطة تسوية استرداد للقراءة فقط لطلب واحد ذي معرّف رقمي يخص الحساب.
POST
https://notpanel.com/api/v3action=refund_quoteمفتاح API مطلوبمحدود بالمعدل (حساب مشترك + IP + إجراء)الجسم:
application/x-www-form-urlencodedلا يلغي
action=refund_quote عنصرًا ولا يغير المحفظة. استخدمه لفهم مبالغ الخصم والاسترداد قبل اختيار إجراء موثق آخر.المعاملات
| الاسم | النوع | الوصف |
|---|---|---|
| keyمطلوب | string | مفتاح API الخاص بك. |
| actionمطلوب | string | يجب أن تكون القيمة الحرفية "refund_quote". |
| orderمطلوب | string | One 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. |