Siparişler
Sipariş durumu
Bir siparişin veya en fazla 100 siparişin güncel durumunu standart biçimde döndürür; ayrıca net ek alanlar sunar: iade, neden ve iptal ya da yenilemenin şu anda mümkün olup olmadığı. Aynı projeksiyon order_details ve webhook'ları besler, bu yüzden her zaman uyumludur.
POST
https://notpanel.com/api/v3action=status- API anahtarı gerekli
- İstek limiti aşıldı
- Gövde:
application/x-www-form-urlencoded
Parametreler
Her zaman gönderilir
keystringZorunlu- API anahtarınız.
actionstringZorunlustatusBirebir "status" dizesi olmalıdır.
order veya orders gönderin.
orderintegerBunlardan biri- Bir sipariş numarası. 2026-08-25 öncesinde verilen siparişler, o zaman aldıkları kimlikle hâlâ okunabilir; yanıt sipariş numarasını kullanır.
ordersstring (CSV)Bunlardan biri- Virgülle ayrılmış en fazla 100 sipariş numarası. İkisi de gönderilirse
ordersgeçerli olur.
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 yerine API sayfanızdaki anahtarı yazın.
{
"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"
}Hatalar
- 400
{"error":"Missing required parameter: order","error_code":"MISSING_PARAMETER","retryable":false,"details":{"param":"order"}}Ne order ne de orders gönderildi.
- 400
{"error":"Maximum 100 IDs per request","error_code":"TOO_MANY_IDS","retryable":false}orders içinde 100 sipariş numarasından fazlası var.
- 404
{"error":"Order not found","error_code":"ORDER_NOT_FOUND","retryable":false}Sipariş yok veya başka bir hesaba ait. Her iki durumda da yanıt aynıdır.
Yanıt alanları
İlk beş alan, panel betiklerinin okuduğu standart biçimi korur ve order numarayı tekrarlar. Diğerleri eklemelerdir.
Yanıt alanları
chargestring- Siparişin şu anda size maliyeti, USD cinsinden, metin olarak. Her türlü iade düşüldükten sonraki net tutardır.
start_countstring- Teslimat başladığındaki sayı veya bilinmiyorsa
"0". statusstring- Durum sözcüğü. Bkz. Durum değerleri.
remainsstring- Henüz teslim edilmemiş miktar. Tamamlanmış sipariş her zaman
"0"gösterir. currencystring- Her zaman
USD. orderinteger- Sipariş numarası.
status_keystring- Mantık için durumun sabit küçük harfli biçimi.
refundstring- Bu sipariş için cüzdanınıza iade edilen para, metin olarak; hiçbir şey iade edilmediyse
0.00. reason_codestring | null- Siparişin neden bu şekilde bittiği veya
null. Bkz. Neden kodları. reasonstring | nullreason_codeiçin sabit bir İngilizce cümle veyanull.can_cancelboolean- İptal şu anda mümkünse, anında ya da talep olarak,
true. cancel_availableboolean- Sipariş şu anda tam iadeyle iptal edilebildiği sürece
true: oluşturulduktan sonraki ilk saniyelerde ya da hiç gönderilmeden beklediği sürece. cancel_statestring | null- İptal talebinden sonra
requestedveyarefused, aksi haldenull. can_refillboolean- Şu anda yenileme talep edilebiliyorsa
true. refill_available_atstring | null- Bir sonraki yenilemenin ne zaman mümkün olacağı veya
null. updated_atstring- Siparişin en son ne zaman değiştiği.
Durum değerleri
- Pending
status_key=pendingPending— kabul edildi ve henüz gönderilmedi. İlk 15 saniye boyunca sipariş ücretsiz iptal edilebilir. - Processing
status_key=processingProcessing— gönderildi ve teslimatın başlaması bekleniyor. Gönderimi onaylanmamış bir sipariş de işleniyor olarak görünür. - In progress
status_key=in_progressTeslimat sürüyor.
- Completed
status_key=completedCompleted— tamamen teslim edildi.remainsher zaman"0"olur. - Partial
status_key=partialPartial— siparişin bir kısmı teslim edildi, kalanı iade edildi. Yenileme mümkün olabilir. - Canceled
status_key=cancelledCanceled— artık hiçbir şey teslim edilmeyecek ve ücret tam veya kısmen iade edildi.reason_codenedenini söyler.
Neden kodları
Bir sipariş erken bittiğinde reason_code nedenini söyler ve reason sabit cümleyi içerir. Para refund içindedir, asla cümlede değil. Bilinmeyen bir kodu genel bir neden olarak ele alın: yeni kodlar eklenebilir.
Neden kodları ve cümleler
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.
İadeler ve ücret
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"
}Aynı anda çok sayıda sipariş
orders ile yanıt, istenen her kimliğe göre anahtarlanmış bir nesnedir. Her kimlik ya durum nesnesini ya da hata nesnesini alır ve HTTP durumu 200 kalır. İstek başına en fazla 100 kimlik.
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"
}
}