Заказы

Отмена заказа

Одно действие отменяет любой заказ. В течение первых 15 с отмена мгновенная и возвращает всё. Позже она становится запросом там, где услуга это поддерживает. Передайте order, чтобы получить один объект, или orders, чтобы получить массив с одной записью на заказ.

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

Требуется API-ключ
Превышен лимит запросов
Тело:application/x-www-form-urlencoded

Один объект или список

order возвращает один объект с cancel: 1, status, status_key, refund и state (canceled или requested). Отказ — обычный ответ с ошибкой и своим HTTP-статусом. orders возвращает массив в том порядке, в котором вы отправили заказы, и каждая запись сообщает canceled, requested или содержит объект ошибки в cancel. Повторный запрос в течение 10 мин возвращает сохранённый ответ без повторного обращения.

Параметры

Передаётся всегда

keystringОбязательный: Ваш API-ключ.
actionstringОбязательный: cancelДолжно быть буквальной строкой «cancel».

Передайте `order` или `orders`.

orderintegerОдно из них: Один номер заказа.
ordersstring (CSV)Одно из них: До 100 номеров заказов через запятую. Cancel считает идентификаторы заказов: 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 ключом со страницы API.

Ответ200 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
    }
  }
]

Ошибки

400
{"error":"Maximum 100 IDs per request","error_code":"TOO_MANY_IDS","retryable":false}
В orders больше 100 номеров заказов.
429
{"error":"Rate limit exceeded","error_code":"API_RATE_LIMITED","retryable":true,"retry_after":12}
Больше 30 идентификаторов заказов за минуту. Подождите по Retry-After.

Все коды статусов

Что может сообщать запись

Записи возвращаются в том порядке, в котором вы их отправили. Проблема с одним заказом никогда не останавливает остальные.

Ответы

canceled: state: "canceled" с refund. Заказ отменён сразу и полностью возвращён: он был в пределах первых 15 с или ещё не был отправлен.
requested: state: "requested". Запрос на отмену записан и отправлен. Заказ продолжает выполняться, пока услуга не примет решение, а любой возврат делается автоматически.
asked_again: Снова state: "requested". Вы спросили в течение 10 мин после последнего ответа, поэтому возвращается сохранённый ответ и повторно ничего не запрашивается. Через 10 мин запрос отправляется снова.
CANCEL_REFUSED: Услуга отказала. retry_after и details.time указывают, когда можно спросить снова.
CANCEL_NOT_AVAILABLE: Этот заказ нельзя отменить, например потому, что услуга не поддерживает запросы на отмену.
ORDER_FINISHED: Заказ уже завершён.
ORDER_NOT_FOUND: В вашем аккаунте нет такого заказа.

Мгновенная отмена

В течение первых 15 с после оформления любой заказ можно отменить с полным возвратом, какой бы ни была услуга. Заказ, который ожидает и ни разу не отправлялся, также можно мгновенно отменить в любой момент. Возврат входит в запись.

Запрос

key=YOUR_API_KEY&action=cancel&order=1234574

Ответ200 OK

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

Запросы на отмену

После бесплатного окна отмена — это запрос. Он работает только для услуг, у которых cancel равен true в списке, и только пока заказ обрабатывается или выполняется. Всё, что ещё не выполнено, возвращается автоматически, а status показывает can_cancel и cancel_state.

Запрос — не обещание. Заказ всё ещё может быть выполнен, и тогда возвращать нечего. Отклонённый запрос можно повторить после времени, указанного в ответе.

Запрос

key=YOUR_API_KEY&action=cancel&order=1234576

Ответ409 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
}

Список услуг Статус заказа

Ошибки отмены

При order это весь ответ, с их HTTP-статусом. При orders они появляются внутри записей массива, и только TOO_MANY_IDS приводит к ошибке всего запроса.

404
ORDER_NOT_FOUND
Order not found
Заказа с таким номером нет в вашем аккаунте. Сначала исправьте запрос.
409
ORDER_FINISHED
Order is already {status}
Заказ уже завершён. Сначала исправьте запрос.
409
CANCEL_NOT_AVAILABLE
Cancel is not available for this order
Отменить этот заказ нельзя. Сначала исправьте запрос.
409
CANCEL_REFUSED
The order could not be canceled. You can ask again after {time}.
Запрос на отмену отклонён. Можно спросить снова по истечении времени из details.time. Повтор может помочь.
400
TOO_MANY_IDS
Maximum 100 IDs per request
В списке больше идентификаторов, чем может содержать один запрос. Сначала исправьте запрос.

Отмена заказа

Параметры

Передаётся всегда

keystringОбязательный: Ваш API-ключ.
actionstringОбязательный: cancelДолжно быть буквальной строкой «cancel».

Передайте `order` или `orders`.

orderintegerОдно из них: Один номер заказа.
ordersstring (CSV)Одно из них: До 100 номеров заказов через запятую. Cancel считает идентификаторы заказов: 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 } } ]

Ошибки

400

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

В orders больше 100 номеров заказов.

429

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

Больше 30 идентификаторов заказов за минуту. Подождите по Retry-After.

Что может сообщать запись

Ответы

canceled: state: "canceled" с refund. Заказ отменён сразу и полностью возвращён: он был в пределах первых 15 с или ещё не был отправлен.
requested: state: "requested". Запрос на отмену записан и отправлен. Заказ продолжает выполняться, пока услуга не примет решение, а любой возврат делается автоматически.
asked_again: Снова state: "requested". Вы спросили в течение 10 мин после последнего ответа, поэтому возвращается сохранённый ответ и повторно ничего не запрашивается. Через 10 мин запрос отправляется снова.
CANCEL_REFUSED: Услуга отказала. retry_after и details.time указывают, когда можно спросить снова.
CANCEL_NOT_AVAILABLE: Этот заказ нельзя отменить, например потому, что услуга не поддерживает запросы на отмену.
ORDER_FINISHED: Заказ уже завершён.
ORDER_NOT_FOUND: В вашем аккаунте нет такого заказа.

Мгновенная отмена

Запрос

key=YOUR_API_KEY&action=cancel&order=1234574

Ответ200 OK

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

Запросы на отмену

Запрос

key=YOUR_API_KEY&action=cancel&order=1234576

Ответ409 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
}

Список услуг Статус заказа

Ошибки отмены

404
ORDER_NOT_FOUND
Order not found
Заказа с таким номером нет в вашем аккаунте. Сначала исправьте запрос.
409
ORDER_FINISHED
Order is already {status}
Заказ уже завершён. Сначала исправьте запрос.
409
CANCEL_NOT_AVAILABLE
Cancel is not available for this order
Отменить этот заказ нельзя. Сначала исправьте запрос.
409
CANCEL_REFUSED
The order could not be canceled. You can ask again after {time}.
Запрос на отмену отклонён. Можно спросить снова по истечении времени из details.time. Повтор может помочь.
400
TOO_MANY_IDS
Maximum 100 IDs per request
В списке больше идентификаторов, чем может содержать один запрос. Сначала исправьте запрос.

Отмена заказа

Параметры

Передаётся всегда

Передайте order или orders.

Ошибки

Что может сообщать запись

Ответы

Мгновенная отмена

Запросы на отмену

Ошибки отмены

Отмена заказа

Параметры

Передаётся всегда

Передайте order или orders.

Ошибки

Что может сообщать запись

Ответы

Мгновенная отмена

Запросы на отмену

Ошибки отмены

Передайте `order` или `orders`.

Передайте `order` или `orders`.