Siparişler

Sipariş iptali

Tek bir işlem her siparişi iptal eder. İlk 15 saniye boyunca iptal anındadır ve her şeyi iade eder. Sonrasında, hizmetin desteklediği yerlerde bir talebe dönüşür. Tek nesne için order, sipariş başına bir girdi içeren dizi için orders gönderin.

POSThttps://notpanel.com/api/v3action=cancel

API anahtarı gerekli
İstek limiti aşıldı
Gövde:application/x-www-form-urlencoded

Tek nesne veya bir liste

order, cancel: 1, status, status_key, refund ve state (canceled veya requested) içeren tek bir nesne döndürür. Ret, HTTP durumuyla birlikte normal bir hata yanıtıdır. orders, gönderdiğiniz sırayla bir dizi döndürür ve her girdi canceled, requested der veya cancel içinde bir hata nesnesi taşır. 10 dakika içinde yeniden sormak, kimseye tekrar sormadan kayıtlı yanıtı döndürür.

Parametreler

Her zaman gönderilir

keystringZorunlu: API anahtarınız.
actionstringZorunlu: cancelBirebir "cancel" dizesi olmalıdır.

`order` veya `orders` gönderin.

orderintegerBunlardan biri: Bir sipariş numarası.
ordersstring (CSV)Bunlardan biri: Virgülle ayrılmış en fazla 100 sipariş numarası. Cancel sipariş kimliklerini sayar: hesap başına dakikada 30.

curl -X POST https://notpanel.com/api/v3 \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "key=YOUR_API_KEY&action=cancel&orders=1,2,3"

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",
    orders: "1,2,3",
  }),
});

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",
    "orders": "1,2,3",
},
)
print(res.json())

<?php
$body = http_build_query([
    'key' => 'YOUR_API_KEY',
    'action' => 'cancel',
    'orders' => '1,2,3',
]);

$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.

Yanıt200 OK

[
  {
    "order": 1,
    "cancel": 1,
    "state": "canceled",
    "refund": "1.20"
  },
  {
    "order": 2,
    "cancel": 1,
    "state": "requested"
  },
  {
    "order": 3,
    "cancel": {
      "error": "Cancel is not available for this order",
      "error_code": "CANCEL_NOT_AVAILABLE",
      "retryable": false
    }
  }
]

Hatalar

400
{"error":"Maximum 100 IDs per request","error_code":"TOO_MANY_IDS","retryable":false}
orders içinde 100 sipariş numarasından fazlası var.
429
{"error":"Rate limit exceeded","error_code":"API_RATE_LIMITED","retryable":true,"retry_after":12}
Bir dakikada 30 sipariş kimliğinden fazlası. Retry-After kadar bekleyin.

Tüm durum kodları

Bir girdi ne diyebilir

Girdiler gönderdiğiniz sırayla döner. Bir siparişteki sorun diğerlerini asla durdurmaz.

Yanıtlar

canceled: refund ile state: "canceled". Sipariş hemen iptal edildi ve tamamen iade edildi: ilk 15 saniye içindeydi veya henüz gönderilmemişti.
requested: state: "requested". Bir iptal talebi kaydedildi ve gönderildi. Hizmet karar verene kadar sipariş çalışmaya devam eder ve her iade otomatik yapılır.
asked_again: Yine state: "requested". Son yanıttan sonra 10 dakika içinde sordunuz, bu yüzden kayıtlı yanıt döndürülür ve tekrar bir şey sorulmaz. 10 dakika sonra talep yeniden gönderilir.
CANCEL_REFUSED: Hizmet hayır dedi. retry_after ve details.time ne zaman yeniden sorabileceğinizi söyler.
CANCEL_NOT_AVAILABLE: Bu sipariş iptal edilemez, örneğin hizmet iptal taleplerini desteklemediği için.
ORDER_FINISHED: Sipariş zaten bitti.
ORDER_NOT_FOUND: Hesabınızda böyle bir sipariş yok.

Anında iptal

Verildikten sonraki ilk 15 saniye boyunca her sipariş, hizmet ne olursa olsun tam iadeyle iptal edilebilir. Bekleyen ve hiç gönderilmemiş bir sipariş de her zaman anında iptal edilebilir. İade girdinin bir parçasıdır.

İstek

key=YOUR_API_KEY&action=cancel&order=1234574

Yanıt200 OK

{
  "order": 1234574,
  "status": "Canceled",
  "status_key": "cancelled",
  "cancel": 1,
  "state": "canceled",
  "refund": "1.20",
  "refund_pending": 0
}

İptal talepleri

Ücretsiz pencereden sonra iptal bir taleptir. Yalnızca listede cancel değeri true olan hizmetlerde ve yalnızca sipariş işlenirken veya devam ederken çalışır. Henüz teslim edilmeyen her şey otomatik iade edilir ve status, can_cancel ve cancel_state değerlerini gösterir.

Bir talep söz değildir. Sipariş yine de tamamlanabilir ve o zaman iade edilecek bir şey kalmaz. Reddedilen bir talep, yanıttaki süreden sonra tekrarlanabilir.

İstek

key=YOUR_API_KEY&action=cancel&order=1234576

Yanıt409 Conflict

{
  "error": "The order could not be canceled. You can ask again after 2026-10-03T10:10:00.000Z.",
  "error_code": "CANCEL_REFUSED",
  "retryable": true,
  "details": {
    "time": "2026-10-03T10:10:00.000Z"
  },
  "retry_after": 540
}

Servisleri listeleme Sipariş durumu

İptal hataları

order ile bunlar yanıtın tamamıdır ve HTTP durumlarıyla gelir. orders ile dizi girdilerinin içinde görünür ve yalnızca TOO_MANY_IDS tüm isteği başarısız kılar.

404
ORDER_NOT_FOUND
Order not found
Bu numaralı hiçbir sipariş hesabınıza ait değil. Önce isteği düzeltin.
409
ORDER_FINISHED
Order is already {status}
Sipariş zaten bitti. Önce isteği düzeltin.
409
CANCEL_NOT_AVAILABLE
Cancel is not available for this order
Bu sipariş için iptal mümkün değil. Önce isteği düzeltin.
409
CANCEL_REFUSED
The order could not be canceled. You can ask again after {time}.
İptal talebi reddedildi. details.time içindeki süreden sonra yeniden sorabilirsiniz. Yeniden denemek işe yarayabilir.
400
TOO_MANY_IDS
Maximum 100 IDs per request
Bir liste, tek bir isteğin taşıyabileceğinden fazla kimlik içeriyor. Önce isteği düzeltin.

Parametreler

Her zaman gönderilir

keystringZorunlu: API anahtarınız.
actionstringZorunlu: cancelBirebir "cancel" dizesi olmalıdır.

`order` veya `orders` gönderin.

orderintegerBunlardan biri: Bir sipariş numarası.
ordersstring (CSV)Bunlardan biri: Virgülle ayrılmış en fazla 100 sipariş numarası. Cancel sipariş kimliklerini sayar: hesap başına dakikada 30.

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", orders: "1,2,3", }), }); const data = await res.json(); console.log(data);

<?php $body = http_build_query([ 'key' => 'YOUR_API_KEY', 'action' => 'cancel', 'orders' => '1,2,3', ]); $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": 1, "cancel": 1, "state": "canceled", "refund": "1.20" }, { "order": 2, "cancel": 1, "state": "requested" }, { "order": 3, "cancel": { "error": "Cancel is not available for this order", "error_code": "CANCEL_NOT_AVAILABLE", "retryable": false } } ]

Hatalar

400

{"error":"Maximum 100 IDs per request","error_code":"TOO_MANY_IDS","retryable":false}

orders içinde 100 sipariş numarasından fazlası var.

429

{"error":"Rate limit exceeded","error_code":"API_RATE_LIMITED","retryable":true,"retry_after":12}

Bir dakikada 30 sipariş kimliğinden fazlası. Retry-After kadar bekleyin.

Bir girdi ne diyebilir

Girdiler gönderdiğiniz sırayla döner. Bir siparişteki sorun diğerlerini asla durdurmaz.

Yanıtlar

canceled: refund ile state: "canceled". Sipariş hemen iptal edildi ve tamamen iade edildi: ilk 15 saniye içindeydi veya henüz gönderilmemişti.
requested: state: "requested". Bir iptal talebi kaydedildi ve gönderildi. Hizmet karar verene kadar sipariş çalışmaya devam eder ve her iade otomatik yapılır.
asked_again: Yine state: "requested". Son yanıttan sonra 10 dakika içinde sordunuz, bu yüzden kayıtlı yanıt döndürülür ve tekrar bir şey sorulmaz. 10 dakika sonra talep yeniden gönderilir.
CANCEL_REFUSED: Hizmet hayır dedi. retry_after ve details.time ne zaman yeniden sorabileceğinizi söyler.
CANCEL_NOT_AVAILABLE: Bu sipariş iptal edilemez, örneğin hizmet iptal taleplerini desteklemediği için.
ORDER_FINISHED: Sipariş zaten bitti.
ORDER_NOT_FOUND: Hesabınızda böyle bir sipariş yok.

Anında iptal

İstek

key=YOUR_API_KEY&action=cancel&order=1234574

Yanıt200 OK

{
  "order": 1234574,
  "status": "Canceled",
  "status_key": "cancelled",
  "cancel": 1,
  "state": "canceled",
  "refund": "1.20",
  "refund_pending": 0
}

İptal talepleri

Bir talep söz değildir. Sipariş yine de tamamlanabilir ve o zaman iade edilecek bir şey kalmaz. Reddedilen bir talep, yanıttaki süreden sonra tekrarlanabilir.

İstek

key=YOUR_API_KEY&action=cancel&order=1234576

Yanıt409 Conflict

{
  "error": "The order could not be canceled. You can ask again after 2026-10-03T10:10:00.000Z.",
  "error_code": "CANCEL_REFUSED",
  "retryable": true,
  "details": {
    "time": "2026-10-03T10:10:00.000Z"
  },
  "retry_after": 540
}

Servisleri listeleme Sipariş durumu

İptal hataları

order ile bunlar yanıtın tamamıdır ve HTTP durumlarıyla gelir. orders ile dizi girdilerinin içinde görünür ve yalnızca TOO_MANY_IDS tüm isteği başarısız kılar.

404
ORDER_NOT_FOUND
Order not found
Bu numaralı hiçbir sipariş hesabınıza ait değil. Önce isteği düzeltin.
409
ORDER_FINISHED
Order is already {status}
Sipariş zaten bitti. Önce isteği düzeltin.
409
CANCEL_NOT_AVAILABLE
Cancel is not available for this order
Bu sipariş için iptal mümkün değil. Önce isteği düzeltin.
409
CANCEL_REFUSED
The order could not be canceled. You can ask again after {time}.
İptal talebi reddedildi. details.time içindeki süreden sonra yeniden sorabilirsiniz. Yeniden denemek işe yarayabilir.
400
TOO_MANY_IDS
Maximum 100 IDs per request
Bir liste, tek bir isteğin taşıyabileceğinden fazla kimlik içeriyor. Önce isteği düzeltin.

Sipariş iptali

Parametreler

Her zaman gönderilir

order veya orders gönderin.

Hatalar

Bir girdi ne diyebilir

Yanıtlar

Anında iptal

İptal talepleri

İptal hataları

Sipariş iptali

Parametreler

Her zaman gönderilir

order veya orders gönderin.

Hatalar

Bir girdi ne diyebilir

Yanıtlar

Anında iptal

İptal talepleri

İptal hataları

`order` veya `orders` gönderin.

`order` veya `orders` gönderin.