Pedidos

Refill

Un pedido terminado se puede reponer cuando el servicio lo admite. Cada pedido se puede reponer una vez cada 6 horas, sin fecha límite. refill_status muestra el resultado y, si se rechazó, el motivo.

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

Clave de API requerida
Límite de solicitudes superado
Cuerpo:application/x-www-form-urlencoded

Cada 6 horas

Una solicitud de reposición por pedido cada 6 horas, contadas desde la solicitud anterior sea cual sea su resultado. Si vuelves a pedir demasiado pronto, recibes REFILL_COOLDOWN con el momento en que puedes pedir.

Parámetros

Siempre se envía

keystringObligatorio: Tu clave de API.
actionstringObligatorio: refillDebe ser la cadena literal "refill".

Envía `order` u `orders`.

orderintegerUno de estos: Un número de pedido. La respuesta es un objeto con el nuevo ID de reposición en refill.
ordersstring (CSV)Uno de estos: Hasta 100 números de pedido separados por comas. La respuesta es un array; 30 ID de pedido por minuto.

curl -X POST https://notpanel.com/api/v3 \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "key=YOUR_API_KEY&action=refill&order=1234567"

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: "refill",
    order: "1234567",
  }),
});

const data = await res.json();
console.log(data);

import requests

res = requests.post(
  "https://notpanel.com/api/v3",
  data={
    "key": "YOUR_API_KEY",
    "action": "refill",
    "order": "1234567",
},
)
print(res.json())

<?php
$body = http_build_query([
    'key' => 'YOUR_API_KEY',
    'action' => 'refill',
    'order' => '1234567',
]);

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

Sustituye YOUR_API_KEY por la clave de tu página de API.

Respuesta200 OK

{
  "refill": 5501
}

Errores

404
{"error":"Order not found","error_code":"ORDER_NOT_FOUND","retryable":false}
No existe ese pedido en tu cuenta.
409
{"error":"You can request a refill again after 2026-10-03T18:35:00.000Z","error_code":"REFILL_COOLDOWN","retryable":true,"details":{"time":"2026-10-03T18:35:00.000Z"}}
Se solicitó una reposición hace menos de 6 horas. details.time indica cuándo puedes volver a pedir.
409
{"error":"Refill is available after the order is completed","error_code":"REFILL_NOT_COMPLETED","retryable":true}
El pedido sigue en curso. La reposición es posible cuando se complete.

Todos los códigos de estado

Cuándo es posible una reposición

El pedido debe estar completado o parcial, el servicio debe admitir reposición (su indicador refill es true) y deben haber pasado al menos 6 horas desde la última solicitud de reposición. No hay límite de tiempo después del pedido. La respuesta a order es el ID de reposición; can_refill y refill_available_at en status te lo indican de antemano.

Listar servicios

Muchos pedidos

Con orders la respuesta es un array con una entrada por pedido, cada una con el ID de reposición o un objeto de error. Un problema con un pedido nunca detiene a los demás. Hasta 100 ID.

Solicitud

key=YOUR_API_KEY&action=refill&orders=1234567,1234568,1234577

Respuesta200 OK

[
  {
    "order": 1234567,
    "refill": 5501
  },
  {
    "order": 1234568,
    "refill": {
      "error": "You can request a refill again after 2026-10-03T18:35:00.000Z",
      "error_code": "REFILL_COOLDOWN",
      "retryable": true,
      "details": {
        "time": "2026-10-03T18:35:00.000Z"
      }
    }
  },
  {
    "order": 1234577,
    "refill": {
      "error": "Refill is available after the order is completed",
      "error_code": "REFILL_NOT_COMPLETED",
      "retryable": true
    }
  }
]

refill_status

action=refill_status devuelve el estado de una reposición o de hasta 100. Una reposición a la que nadie responde durante 7 días deja de rastrearse y aparece como Pending, de modo que no bloquea una nueva solicitud.

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

Envía `refill` o `refills`

refillintegerUno de estos: Un ID de reposición.
refillsstring (CSV)Uno de estos: Hasta 100 ID de reposición separados por comas.

Campos de la respuesta

statusstring: La palabra de estado. Consulta Valores de estado más abajo.
status_keystring: Forma estable en minúsculas del estado.
orderinteger: El pedido al que pertenece la reposición.
reason_codestring | null: Por qué se rechazó una reposición, o null.
reasonstring | null: Una frase fija en inglés para reason_code, o null.
created_atstring: Cuándo se solicitó la reposición.
updated_atstring: Cuándo cambió por última vez.

Solicitud

key=YOUR_API_KEY&action=refill_status&refill=5501

Respuesta200 OK

{
  "status": "Completed",
  "status_key": "completed",
  "order": 1234567,
  "reason_code": null,
  "reason": null,
  "created_at": "2026-10-03T12:35:00Z",
  "updated_at": "2026-10-03T13:05:00Z"
}

Solicitud

key=YOUR_API_KEY&action=refill_status&refills=5501,5502,9

Respuesta200 OK

[
  {
    "refill": 5501,
    "status": "Completed",
    "status_key": "completed",
    "order": 1234567,
    "reason_code": null,
    "reason": null,
    "created_at": "2026-10-03T12:35:00Z",
    "updated_at": "2026-10-03T13:05:00Z"
  },
  {
    "refill": 5502,
    "status": "Rejected",
    "status_key": "rejected",
    "order": 1234568,
    "reason_code": "refill_too_early",
    "reason": "This order cannot be refilled yet. Try again later.",
    "created_at": "2026-10-03T12:40:00Z",
    "updated_at": "2026-10-03T12:41:00Z"
  },
  {
    "refill": 9,
    "error": "Refill not found",
    "error_code": "REFILL_NOT_FOUND",
    "retryable": false
  }
]

Valores de estado

Pendingstatus_key=pending
Pending — solicitada, o el resultado aún no se conoce.
In progressstatus_key=in_progress
In progress — la reposición se está realizando.
Completedstatus_key=completed
Completed — la reposición se realizó.
Rejectedstatus_key=rejected
Rejected — la reposición fue rechazada. reason_code indica por qué.

Motivos de rechazo

Un rechazo siempre lleva uno de estos códigos. Trata un código desconocido como un rechazo genérico: se pueden añadir códigos nuevos.

Códigos de motivo y frases

refill_too_early: This order cannot be refilled yet. Try again later.
refill_daily_limit: Refills for today are used up. Try again tomorrow.
refill_not_completed: Refill is possible after the order is completed.
refill_not_eligible: This order cannot be refilled.
refill_refused: The refill was not accepted. Try again later.

Cuando se pide una reposición pero nadie responde, permanece Pending y nunca se envía dos veces por accidente.

Errores de reposición

404
ORDER_NOT_FOUND
Order not found
Ningún pedido con este número pertenece a tu cuenta. Corrige primero la solicitud.
409
REFILL_NOT_AVAILABLE
Refill is not available for this order
No es posible reponer este pedido. Corrige primero la solicitud.
409
REFILL_NOT_COMPLETED
Refill is available after the order is completed
La reposición es posible cuando el pedido esté completado. Reintentar puede servir.
409
REFILL_COOLDOWN
You can request a refill again after {time}
Se solicitó hace poco una reposición para este pedido. Inténtalo de nuevo después de details.time. Reintentar puede servir.
409
REFILL_ALREADY_PENDING
A refill request is already in progress for this order
Ya hay una reposición en curso para este pedido. Reintentar puede servir.
404
REFILL_NOT_FOUND
Refill not found
Ninguna reposición con este ID pertenece a tu cuenta. Corrige primero la solicitud.

Pedidos

Refill

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

Clave de API requerida
Límite de solicitudes superado
Cuerpo:application/x-www-form-urlencoded

Cada 6 horas

Parámetros

Siempre se envía

keystringObligatorio: Tu clave de API.
actionstringObligatorio: refillDebe ser la cadena literal "refill".

Envía `order` u `orders`.

orderintegerUno de estos: Un número de pedido. La respuesta es un objeto con el nuevo ID de reposición en refill.
ordersstring (CSV)Uno de estos: Hasta 100 números de pedido separados por comas. La respuesta es un array; 30 ID de pedido por minuto.

curl -X POST https://notpanel.com/api/v3 \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "key=YOUR_API_KEY&action=refill&order=1234567"

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: "refill",
    order: "1234567",
  }),
});

const data = await res.json();
console.log(data);

import requests

res = requests.post(
  "https://notpanel.com/api/v3",
  data={
    "key": "YOUR_API_KEY",
    "action": "refill",
    "order": "1234567",
},
)
print(res.json())

<?php
$body = http_build_query([
    'key' => 'YOUR_API_KEY',
    'action' => 'refill',
    'order' => '1234567',
]);

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

Sustituye YOUR_API_KEY por la clave de tu página de API.

Respuesta200 OK

{
  "refill": 5501
}

Errores

404
{"error":"Order not found","error_code":"ORDER_NOT_FOUND","retryable":false}
No existe ese pedido en tu cuenta.
409
{"error":"You can request a refill again after 2026-10-03T18:35:00.000Z","error_code":"REFILL_COOLDOWN","retryable":true,"details":{"time":"2026-10-03T18:35:00.000Z"}}
Se solicitó una reposición hace menos de 6 horas. details.time indica cuándo puedes volver a pedir.
409
{"error":"Refill is available after the order is completed","error_code":"REFILL_NOT_COMPLETED","retryable":true}
El pedido sigue en curso. La reposición es posible cuando se complete.

Todos los códigos de estado

Cuándo es posible una reposición

Listar servicios

Muchos pedidos

Con orders la respuesta es un array con una entrada por pedido, cada una con el ID de reposición o un objeto de error. Un problema con un pedido nunca detiene a los demás. Hasta 100 ID.

Solicitud

key=YOUR_API_KEY&action=refill&orders=1234567,1234568,1234577

Respuesta200 OK

[
  {
    "order": 1234567,
    "refill": 5501
  },
  {
    "order": 1234568,
    "refill": {
      "error": "You can request a refill again after 2026-10-03T18:35:00.000Z",
      "error_code": "REFILL_COOLDOWN",
      "retryable": true,
      "details": {
        "time": "2026-10-03T18:35:00.000Z"
      }
    }
  },
  {
    "order": 1234577,
    "refill": {
      "error": "Refill is available after the order is completed",
      "error_code": "REFILL_NOT_COMPLETED",
      "retryable": true
    }
  }
]

refill_status

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

Envía `refill` o `refills`

refillintegerUno de estos: Un ID de reposición.
refillsstring (CSV)Uno de estos: Hasta 100 ID de reposición separados por comas.

Campos de la respuesta

statusstring: La palabra de estado. Consulta Valores de estado más abajo.
status_keystring: Forma estable en minúsculas del estado.
orderinteger: El pedido al que pertenece la reposición.
reason_codestring | null: Por qué se rechazó una reposición, o null.
reasonstring | null: Una frase fija en inglés para reason_code, o null.
created_atstring: Cuándo se solicitó la reposición.
updated_atstring: Cuándo cambió por última vez.

Solicitud

key=YOUR_API_KEY&action=refill_status&refill=5501

Respuesta200 OK

{
  "status": "Completed",
  "status_key": "completed",
  "order": 1234567,
  "reason_code": null,
  "reason": null,
  "created_at": "2026-10-03T12:35:00Z",
  "updated_at": "2026-10-03T13:05:00Z"
}

Solicitud

key=YOUR_API_KEY&action=refill_status&refills=5501,5502,9

Respuesta200 OK

[
  {
    "refill": 5501,
    "status": "Completed",
    "status_key": "completed",
    "order": 1234567,
    "reason_code": null,
    "reason": null,
    "created_at": "2026-10-03T12:35:00Z",
    "updated_at": "2026-10-03T13:05:00Z"
  },
  {
    "refill": 5502,
    "status": "Rejected",
    "status_key": "rejected",
    "order": 1234568,
    "reason_code": "refill_too_early",
    "reason": "This order cannot be refilled yet. Try again later.",
    "created_at": "2026-10-03T12:40:00Z",
    "updated_at": "2026-10-03T12:41:00Z"
  },
  {
    "refill": 9,
    "error": "Refill not found",
    "error_code": "REFILL_NOT_FOUND",
    "retryable": false
  }
]

Valores de estado

Pendingstatus_key=pending
Pending — solicitada, o el resultado aún no se conoce.
In progressstatus_key=in_progress
In progress — la reposición se está realizando.
Completedstatus_key=completed
Completed — la reposición se realizó.
Rejectedstatus_key=rejected
Rejected — la reposición fue rechazada. reason_code indica por qué.

Motivos de rechazo

Un rechazo siempre lleva uno de estos códigos. Trata un código desconocido como un rechazo genérico: se pueden añadir códigos nuevos.

Códigos de motivo y frases

refill_too_early: This order cannot be refilled yet. Try again later.
refill_daily_limit: Refills for today are used up. Try again tomorrow.
refill_not_completed: Refill is possible after the order is completed.
refill_not_eligible: This order cannot be refilled.
refill_refused: The refill was not accepted. Try again later.

Cuando se pide una reposición pero nadie responde, permanece Pending y nunca se envía dos veces por accidente.

Errores de reposición

404
ORDER_NOT_FOUND
Order not found
Ningún pedido con este número pertenece a tu cuenta. Corrige primero la solicitud.
409
REFILL_NOT_AVAILABLE
Refill is not available for this order
No es posible reponer este pedido. Corrige primero la solicitud.
409
REFILL_NOT_COMPLETED
Refill is available after the order is completed
La reposición es posible cuando el pedido esté completado. Reintentar puede servir.
409
REFILL_COOLDOWN
You can request a refill again after {time}
Se solicitó hace poco una reposición para este pedido. Inténtalo de nuevo después de details.time. Reintentar puede servir.
409
REFILL_ALREADY_PENDING
A refill request is already in progress for this order
Ya hay una reposición en curso para este pedido. Reintentar puede servir.
404
REFILL_NOT_FOUND
Refill not found
Ninguna reposición con este ID pertenece a tu cuenta. Corrige primero la solicitud.

Refill

Parámetros

Siempre se envía

Envía order u orders.

Errores

Cuándo es posible una reposición

Muchos pedidos

refill_status

Envía refill o refills

Campos de la respuesta

Valores de estado

Motivos de rechazo

Códigos de motivo y frases

Errores de reposición

Refill

Parámetros

Siempre se envía

Envía order u orders.

Errores

Cuándo es posible una reposición

Muchos pedidos

refill_status

Envía refill o refills

Campos de la respuesta

Valores de estado

Motivos de rechazo

Códigos de motivo y frases

Errores de reposición

Envía `order` u `orders`.

Envía `refill` o `refills`

Envía `order` u `orders`.

Envía `refill` o `refills`