ऑर्डर
ऑर्डर स्टेटस
एक ऑर्डर या 100 तक ऑर्डर की मौजूदा स्थिति मानक रूप में लौटाता है, साथ में स्पष्ट अतिरिक्त फ़ील्ड: रिफंड, कारण, और रद्द या रिफिल अभी संभव है या नहीं। वही प्रोजेक्शन order_details और webhooks को भी देता है, इसलिए वे हमेशा एक जैसे रहते हैं।
POST
https://notpanel.com/api/v3action=status- API की आवश्यक
- रेट लिमिट पार
- बॉडी:
application/x-www-form-urlencoded
पैरामीटर
हमेशा भेजा जाता है
keystringआवश्यक- आपकी API की।
actionstringआवश्यकstatusलिटरल स्ट्रिंग "status" होना चाहिए।
order या orders भेजें।
orderintegerइनमें से एक- एक ऑर्डर नंबर। 2026-08-25 से पहले दिए गए ऑर्डर अब भी उस समय मिले आईडी से पढ़े जा सकते हैं; जवाब में ऑर्डर नंबर इस्तेमाल होता है।
ordersstring (CSV)इनमें से एक- कॉमा से अलग अधिकतम 100 ऑर्डर नंबर। दोनों भेजे जाएँ तो
ordersमान्य होता है।
curl -X POST https://notpanel.com/api/v3 \
-H "Content-Type: application/x-www-form-urlencoded" \
-d "key=YOUR_API_KEY&action=status&order=1234568"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: "1234568",
}),
});
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": "1234568",
},
)
print(res.json())<?php
$body = http_build_query([
'key' => 'YOUR_API_KEY',
'action' => 'status',
'order' => '1234568',
]);
$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));
YOUR_API_KEY की जगह अपने API पेज की की डालें।
{
"charge": "0.87",
"start_count": "3572",
"status": "Partial",
"remains": "157",
"currency": "USD",
"order": 1234568,
"status_key": "partial",
"refund": "0.13",
"reason_code": "partially_delivered",
"reason": "Part of the order was delivered. The rest was refunded.",
"can_cancel": false,
"cancel_available": false,
"cancel_state": null,
"can_refill": true,
"refill_available_at": null,
"updated_at": "2026-10-03T12:00:00Z"
}एरर
- 400
{"error":"Missing required parameter: order","error_code":"MISSING_PARAMETER","retryable":false,"details":{"param":"order"}}न order भेजा गया, न orders।
- 400
{"error":"Maximum 100 IDs per request","error_code":"TOO_MANY_IDS","retryable":false}orders में 100 से अधिक ऑर्डर नंबर हैं।
- 404
{"error":"Order not found","error_code":"ORDER_NOT_FOUND","retryable":false}ऑर्डर मौजूद नहीं है या किसी दूसरे खाते का है। दोनों स्थितियों में जवाब एक जैसा होता है।
रिस्पॉन्स फ़ील्ड
पहले पाँच फ़ील्ड वही मानक रूप रखते हैं जिसे पैनल स्क्रिप्ट पढ़ती हैं, और order नंबर दोहराता है। बाकी जोड़े गए हैं।
रिस्पॉन्स फ़ील्ड
chargestring- ऑर्डर की अभी आपको कितनी लागत है, USD में, स्ट्रिंग के रूप में। यह किसी भी रिफंड के बाद की शुद्ध राशि है।
start_countstring- डिलीवरी शुरू होने पर की गिनती, या जब पता न हो तब
"0"। statusstring- स्टेटस शब्द। स्टेटस मान देखें।
remainsstring- जो मात्रा अभी डिलीवर नहीं हुई। पूर्ण ऑर्डर में हमेशा
"0"दिखता है। currencystring- हमेशा
USD। orderinteger- ऑर्डर नंबर।
status_keystring- लॉजिक के लिए स्टेटस का स्थिर छोटे अक्षरों वाला रूप।
refundstring- इस ऑर्डर के लिए आपके वॉलेट में लौटाया गया पैसा, टेक्स्ट के रूप में; कुछ न लौटाया गया हो तो
0.00। reason_codestring | null- ऑर्डर इस तरह क्यों खत्म हुआ, या
null। कारण कोड देखें। reasonstring | nullreason_codeके लिए एक तय अंग्रेज़ी वाक्य, याnull।can_cancelbooleantrueजब अभी रद्द करना संभव हो, तुरंत या अनुरोध के रूप में।cancel_availablebooleantrueजब तक ऑर्डर अभी पूरे रिफ़ंड के साथ रद्द किया जा सकता है: ऑर्डर देने के शुरुआती सेकंड में, या जब तक वह इंतज़ार में है और भेजा नहीं गया।cancel_statestring | null- रद्द करने के अनुरोध के बाद
requestedयाrefused, अन्यथाnull। can_refillbooleantrueजब अभी रिफिल का अनुरोध किया जा सकता हो।refill_available_atstring | null- अगला रिफिल कब संभव होगा, या
null। updated_atstring- ऑर्डर आखिरी बार कब बदला।
स्टेटस मान
- Pending
status_key=pendingPending— स्वीकार हुआ और अभी भेजा नहीं गया। पहले 15 सेकंड तक ऑर्डर मुफ़्त रद्द किया जा सकता है। - Processing
status_key=processingProcessing— भेजा गया और डिलीवरी शुरू होने की प्रतीक्षा में। जिस ऑर्डर का भेजा जाना पुष्ट नहीं है, वह भी प्रोसेसिंग में दिखता है। - In progress
status_key=in_progressDelivery जारी है।
- Completed
status_key=completedCompleted— पूरी तरह डिलीवर हुआ।remainsहमेशा"0"रहता है। - Partial
status_key=partialPartial— ऑर्डर का एक हिस्सा डिलीवर हुआ और बाकी का रिफंड हुआ। रिफिल उपलब्ध हो सकता है। - Canceled
status_key=cancelledCanceled— अब कुछ और डिलीवर नहीं होगा और शुल्क पूरा या आंशिक रूप से वापस किया गया।reason_codeकारण बताता है।
कारण कोड
जब ऑर्डर जल्दी खत्म होता है, तो reason_code कारण बताता है और reason में तय वाक्य होता है। पैसा refund में होता है, वाक्य में कभी नहीं। अज्ञात कोड को सामान्य कारण मानें: नए कोड जोड़े जा सकते हैं।
कारण कोड और वाक्य
customer_canceled- You canceled this order. The charge was refunded.
canceled_on_request- Canceled at your request. The charge was refunded.
canceled_on_request_partial- Canceled at your request. Part of the order was delivered. The rest was refunded.
canceled_overdue- Canceled because it took too long. The charge was refunded.
delivery_canceled- This order was canceled. The charge was refunded.
partially_delivered- Part of the order was delivered. The rest was refunded.
link_invalid- The link is wrong or private. The charge was refunded.
link_busy- This link already had an active order. The charge was refunded.
service_unavailable- The service was not available. The charge was refunded.
quantity_rejected- The quantity was not accepted. The charge was refunded.
details_rejected- The order details were not accepted. The charge was refunded.
price_changed- The price changed before the order started. The charge was refunded.
start_failed- The order could not be started. The charge was refunded.
not_started_in_time- The order could not be started in time. The charge was refunded.
admin_refund- Refunded by support.
admin_completed- Marked completed by support.
legacy_canceled- Canceled.
legacy_refunded- Refunded.
रिफंड और शुल्क
key=YOUR_API_KEY&action=status&order=1234569{
"charge": "0.00",
"start_count": "0",
"status": "Canceled",
"remains": "1000",
"currency": "USD",
"order": 1234569,
"status_key": "cancelled",
"refund": "1.20",
"reason_code": "customer_canceled",
"reason": "You canceled this order. The charge was refunded.",
"can_cancel": false,
"cancel_available": false,
"cancel_state": null,
"can_refill": false,
"refill_available_at": null,
"updated_at": "2026-10-03T10:00:09Z"
}एक साथ कई ऑर्डर
orders के साथ जवाब एक ऑब्जेक्ट होता है जो हर माँगे गए आईडी की कुंजी पर होता है। हर आईडी को उसका स्टेटस ऑब्जेक्ट या एरर ऑब्जेक्ट मिलता है, और HTTP स्टेटस 200 रहता है। प्रति अनुरोध अधिकतम 100 आईडी।
key=YOUR_API_KEY&action=status&orders=1234567,1234568,999{
"999": {
"error": "Order not found",
"error_code": "ORDER_NOT_FOUND",
"retryable": false
},
"1234567": {
"charge": "1.20",
"start_count": "3572",
"status": "Completed",
"remains": "0",
"currency": "USD",
"order": 1234567,
"status_key": "completed",
"refund": "0.00",
"reason_code": null,
"reason": null,
"can_cancel": false,
"cancel_available": false,
"cancel_state": null,
"can_refill": false,
"refill_available_at": "2026-10-03T18:35:00Z",
"updated_at": "2026-10-03T12:35:00Z"
},
"1234568": {
"charge": "0.87",
"start_count": "3572",
"status": "Partial",
"remains": "157",
"currency": "USD",
"order": 1234568,
"status_key": "partial",
"refund": "0.13",
"reason_code": "partially_delivered",
"reason": "Part of the order was delivered. The rest was refunded.",
"can_cancel": false,
"cancel_available": false,
"cancel_state": null,
"can_refill": true,
"refill_available_at": null,
"updated_at": "2026-10-03T12:00:00Z"
}
}