Order

Batalkan order

Satu aksi membatalkan order apa pun. Selama 15 detik pertama pembatalan bersifat instan dan mengembalikan semuanya. Setelah itu menjadi permintaan bila layanan mendukungnya. Kirim order untuk satu objek, atau orders untuk array dengan satu entri per order.

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

API key diperlukan
Batas permintaan tercapai
Body:application/x-www-form-urlencoded

Satu objek atau satu daftar

order mengembalikan satu objek berisi cancel: 1, status, status_key, refund dan state (canceled atau requested). Penolakan adalah balasan error biasa dengan status HTTP-nya. orders mengembalikan array sesuai urutan yang Anda kirim, dan setiap entri berisi canceled, requested, atau membawa objek error di cancel. Bertanya lagi dalam 10 menit mengembalikan jawaban tersimpan tanpa bertanya ke siapa pun lagi.

Parameter

Selalu dikirim

keystringWajib: API key Anda.
actionstringWajib: cancelHarus berupa string literal "cancel".

Kirim `order` atau `orders`.

orderintegerSalah satu dari ini: Satu nomor order.
ordersstring (CSV)Salah satu dari ini: Hingga 100 nomor order dipisahkan koma. Cancel menghitung ID order: 30 per menit per akun.

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));

Ganti YOUR_API_KEY dengan kunci dari halaman API Anda.

Respons200 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
    }
  }
]

Error

400
{"error":"Maximum 100 IDs per request","error_code":"TOO_MANY_IDS","retryable":false}
Lebih dari 100 nomor order di orders.
429
{"error":"Rate limit exceeded","error_code":"API_RATE_LIMITED","retryable":true,"retry_after":12}
Lebih dari 30 ID order dalam semenit. Tunggu sesuai Retry-After.

Semua kode status

Apa yang bisa dikatakan sebuah entri

Entri kembali dalam urutan yang Anda kirim. Masalah pada satu order tidak pernah menghentikan yang lain.

Jawaban

canceled: state: "canceled" dengan refund. Order dibatalkan seketika dan di-refund penuh: berada dalam 15 detik pertama, atau belum dikirim.
requested: state: "requested". Permintaan pembatalan dicatat dan dikirim. Order terus berjalan sampai layanan memutuskan, dan refund apa pun dilakukan otomatis.
asked_again: state: "requested" lagi. Anda bertanya dalam 10 menit sejak jawaban terakhir, sehingga jawaban tersimpan dikembalikan dan tidak ada yang ditanyakan lagi. Setelah 10 menit, permintaan dikirim lagi.
CANCEL_REFUSED: Layanan menolak. retry_after dan details.time menyebutkan kapan Anda bisa bertanya lagi.
CANCEL_NOT_AVAILABLE: Order ini tidak bisa dibatalkan, misalnya karena layanan tidak mendukung permintaan pembatalan.
ORDER_FINISHED: Order sudah selesai.
ORDER_NOT_FOUND: Tidak ada order seperti itu di akun Anda.

Pembatalan instan

Selama 15 detik pertama setelah order dibuat, setiap order bisa dibatalkan dengan refund penuh, apa pun layanannya. Order yang menunggu dan belum pernah dikirim juga bisa dibatalkan secara instan kapan saja. Refund adalah bagian dari entri.

Permintaan

key=YOUR_API_KEY&action=cancel&order=1234574

Respons200 OK

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

Permintaan pembatalan

Setelah jendela gratis, pembatalan berupa permintaan. Hanya berlaku untuk layanan yang cancel-nya true di daftar, dan hanya selama order sedang diproses atau berjalan. Apa pun yang belum terkirim di-refund otomatis, dan status menampilkan can_cancel dan cancel_state.

Permintaan bukan janji. Order masih bisa selesai, dan saat itu tidak ada yang perlu di-refund. Permintaan yang ditolak bisa diulang setelah waktu yang tertera di jawaban.

Permintaan

key=YOUR_API_KEY&action=cancel&order=1234576

Respons409 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
}

Daftar service Status order

Error pembatalan

Dengan order ini adalah seluruh balasan, beserta status HTTP-nya. Dengan orders ini muncul di dalam entri array, dan hanya TOO_MANY_IDS yang menggagalkan seluruh permintaan.

404
ORDER_NOT_FOUND
Order not found
Tidak ada order dengan nomor ini di akun Anda. Perbaiki dulu permintaannya.
409
ORDER_FINISHED
Order is already {status}
Order sudah selesai. Perbaiki dulu permintaannya.
409
CANCEL_NOT_AVAILABLE
Cancel is not available for this order
Pembatalan tidak mungkin untuk order ini. Perbaiki dulu permintaannya.
409
CANCEL_REFUSED
The order could not be canceled. You can ask again after {time}.
Permintaan pembatalan ditolak. Anda bisa bertanya lagi setelah waktu di details.time. Mencoba ulang bisa membantu.
400
TOO_MANY_IDS
Maximum 100 IDs per request
Sebuah daftar berisi lebih banyak ID daripada yang bisa dibawa satu permintaan. Perbaiki dulu permintaannya.

Parameter

Selalu dikirim

keystringWajib: API key Anda.
actionstringWajib: cancelHarus berupa string literal "cancel".

Kirim `order` atau `orders`.

orderintegerSalah satu dari ini: Satu nomor order.
ordersstring (CSV)Salah satu dari ini: Hingga 100 nomor order dipisahkan koma. Cancel menghitung ID order: 30 per menit per akun.

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 } } ]

Error

400

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

Lebih dari 100 nomor order di orders.

429

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

Lebih dari 30 ID order dalam semenit. Tunggu sesuai Retry-After.

Apa yang bisa dikatakan sebuah entri

Entri kembali dalam urutan yang Anda kirim. Masalah pada satu order tidak pernah menghentikan yang lain.

Jawaban

canceled: state: "canceled" dengan refund. Order dibatalkan seketika dan di-refund penuh: berada dalam 15 detik pertama, atau belum dikirim.
requested: state: "requested". Permintaan pembatalan dicatat dan dikirim. Order terus berjalan sampai layanan memutuskan, dan refund apa pun dilakukan otomatis.
asked_again: state: "requested" lagi. Anda bertanya dalam 10 menit sejak jawaban terakhir, sehingga jawaban tersimpan dikembalikan dan tidak ada yang ditanyakan lagi. Setelah 10 menit, permintaan dikirim lagi.
CANCEL_REFUSED: Layanan menolak. retry_after dan details.time menyebutkan kapan Anda bisa bertanya lagi.
CANCEL_NOT_AVAILABLE: Order ini tidak bisa dibatalkan, misalnya karena layanan tidak mendukung permintaan pembatalan.
ORDER_FINISHED: Order sudah selesai.
ORDER_NOT_FOUND: Tidak ada order seperti itu di akun Anda.

Pembatalan instan

Permintaan

key=YOUR_API_KEY&action=cancel&order=1234574

Respons200 OK

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

Permintaan pembatalan

Permintaan bukan janji. Order masih bisa selesai, dan saat itu tidak ada yang perlu di-refund. Permintaan yang ditolak bisa diulang setelah waktu yang tertera di jawaban.

Permintaan

key=YOUR_API_KEY&action=cancel&order=1234576

Respons409 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
}

Daftar service Status order

Error pembatalan

Dengan order ini adalah seluruh balasan, beserta status HTTP-nya. Dengan orders ini muncul di dalam entri array, dan hanya TOO_MANY_IDS yang menggagalkan seluruh permintaan.

404
ORDER_NOT_FOUND
Order not found
Tidak ada order dengan nomor ini di akun Anda. Perbaiki dulu permintaannya.
409
ORDER_FINISHED
Order is already {status}
Order sudah selesai. Perbaiki dulu permintaannya.
409
CANCEL_NOT_AVAILABLE
Cancel is not available for this order
Pembatalan tidak mungkin untuk order ini. Perbaiki dulu permintaannya.
409
CANCEL_REFUSED
The order could not be canceled. You can ask again after {time}.
Permintaan pembatalan ditolak. Anda bisa bertanya lagi setelah waktu di details.time. Mencoba ulang bisa membantu.
400
TOO_MANY_IDS
Maximum 100 IDs per request
Sebuah daftar berisi lebih banyak ID daripada yang bisa dibawa satu permintaan. Perbaiki dulu permintaannya.

Batalkan order

Parameter

Selalu dikirim

Kirim order atau orders.

Error

Apa yang bisa dikatakan sebuah entri

Jawaban

Pembatalan instan

Permintaan pembatalan

Error pembatalan

Batalkan order

Parameter

Selalu dikirim

Kirim order atau orders.

Error

Apa yang bisa dikatakan sebuah entri

Jawaban

Pembatalan instan

Permintaan pembatalan

Error pembatalan

Kirim `order` atau `orders`.

Kirim `order` atau `orders`.