notpanel
服务价格常见问题福利活动API
notpanel

粉丝、点赞和观看,覆盖所有平台。

目录同时包含我们直接运营的服务和经过审核的合作伙伴容量。可用性、时间、补单和滴灌支持均按服务显示;路由和合作伙伴身份保持保密。

产品

  • 服务
  • 价格
  • 价格指数
  • 推荐计划

资源

  • API
  • 博客
  • 常见问题
  • 状态

公司

  • 关于
  • 为何选择 NotPanel
  • 联系我们

法律

  • 服务条款
  • 隐私政策
  • 退款政策

语言

  • English
  • Español
  • Português
  • Русский
  • Türkçe
  • العربية
  • हिन्दी
  • Bahasa Indonesia
  • Français
  • 中文

© 2026 NotPanel 版权所有。

support@notpanel.com
notpanel
API 文档
+
API 文档

简介

  • 概览
  • 快速开始
  • 身份验证
  • 速率限制
  • 错误

目录

  • 列出服务
  • 高级目录
  • 服务类型

订单

  • 下单
  • 订单状态
  • 退款报价
  • 补单
  • 取消

账户

  • 账户状态
  • 余额

Webhook

  • 管理 webhook

参考

  • 更新日志
  • SDK 与库

需要帮助?

support@notpanel.com →

订单状态

返回一个订单或最多 100 个订单的当前状态。Webhook 可减少轮询,但投递为带重试的尽力而为模式,因此请使用此 status action 核对重要状态。

POSThttps://notpanel.com/api/v3action=status
需要 API key受速率限制(共享账户 + IP + action)请求体: application/x-www-form-urlencoded

参数

名称类型描述
key必需string你的 API key。
action必需string必须是字面字符串 “status”。
orderstring单个订单的数字 ID。如果同时发送 order 和 orders,则以 orders 为准。
ordersstring (CSV)最多 100 个以逗号分隔的数字订单 ID。如果同时发送 order 和 orders,则以 orders 为准。

请求示例

将 YOUR_API_KEY 替换为在你仪表盘 API 页面下生成的 key。

curl -X POST https://notpanel.com/api/v3 \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "key=YOUR_API_KEY&action=status&order=7001"
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: "7001",
  }),
});

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": "7001",
},
)
print(res.json())
<?php
$body = http_build_query([
    'key' => 'YOUR_API_KEY',
    'action' => 'status',
    'order' => '7001',
]);

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

响应示例

{
  "status": "In progress",
  "status_key": "in_progress",
  "charge": "0.50",
  "refund": "0.00",
  "refund_pending": 0,
  "refund_pending_amount": "0.00",
  "start_count": "1234",
  "remains": "650",
  "currency": "USD",
  "cancel_available": false,
  "cancel_before": "2026-08-25T10:30:15.000Z",
  "refund_guaranteed_at": "2026-09-01T10:30:00.000Z",
  "refund_policy": "full_if_unresolved_after_7_days"
}

常见错误

状态响应体原因
400{"error":"Missing parameter: order"}未提供 order 或 orders。
400{"error":"Order not found"}该单个订单 ID 不存在或不属于你的账户。
400{"error":"Maximum 100 orders per request"}orders CSV 中包含超过 100 个 ID。请拆分为多个批次。

普通订单金额字段

对于普通订单,charge 是当前存储的扣费,在部分结算后可能已是保留金额或净额。refund 是已记入钱包的金额。refund_pending=1 表示已确认的退款仍在等待钱包腾出余额空间,refund_pending_amount 是该待入账金额。cancelled 或 refunded 行仍可能保留原始 charge,因此不要直接将两者相减。退款对账请使用 action=refund_quote,并读取 original_charge、refunded、refund_pending_amount 和 refundable_now。

多状态响应

当提供 orders 时,响应是一个以订单 ID 为键的对象。不属于你账户的订单会从结果中静默省略——它们不会作为错误返回。

{
  "7001": {
    "status": "Completed",
    "status_key": "completed",
    "charge": "0.50",
    "refund": "0.00",
    "refund_pending": 0,
    "refund_pending_amount": "0.00",
    "start_count": "1234",
    "remains": "0",
    "currency": "USD",
    "cancel_available": false,
    "cancel_before": "2026-08-25T10:30:15.000Z",
    "refund_guaranteed_at": "2026-09-01T10:30:00.000Z",
    "refund_policy": "full_if_unresolved_after_7_days"
  },
  "7002": {
    "status": "Processing",
    "status_key": "cancelling",
    "charge": "10.00",
    "refund": "0.00",
    "start_count": "0",
    "remains": "0",
    "currency": "USD"
  }
}

状态值

  • pending —— 已接受但尚未派发。普通 API 订单有 15 秒全额退款取消窗口;若自原始创建时间起 7 天后仍未解决,则全额退款。
  • processing — 订单已接受,正在等待交付确认。
  • in_progress —— 交付进行中。普通订单在固定 7 天期限时仍未解决会全额退款。
  • completed —— 已完全交付。
  • partial —— 部分交付;可能可以补单。
  • cancelled — 订单已取消,处于最终状态。
  • refunded —— 已退款(交付失败或订单七天未解决保障)。
  • expired —— 旧版终态值。当前普通订单若在 7 天时仍为 pending、processing、in_progress 或 parked,会获得全额退款并返回 refunded。
  • parked —— 因服务暂不可用而在提交前暂存。暂存不会重置计时:若普通订单从原始创建时间起 7 天仍未解决,固定期限会触发全额退款。