读取退款报价

返回账户所属的一个数字订单 ID 的只读退款对账快照。

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

需要 API key受速率限制（共享账户 + IP + action）请求体： application/x-www-form-urlencoded

action=refund_quote 不会取消项目，也不会更改钱包。请用它理解扣费和退款字段，再判断是否适合执行其他已记录的 action。

参数

名称	类型	描述
key必需	string	你的 API key。
action必需	string	必须是字面字符串 "refund_quote"。
order必需	string	One account-owned numeric order ID.

请求示例

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

cURLJavaScriptPythonPHP

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

<?php
$body = http_build_query([
    'key' => 'YOUR_API_KEY',
    'action' => 'refund_quote',
    '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));

响应示例

{
  "order": 7001,
  "kind": "order",
  "status": "In progress",
  "status_key": "in_progress",
  "currency": "USD",
  "original_charge": "0.50",
  "refunded": "0.00",
  "refund_pending": 0,
  "refund_pending_amount": "0.00",
  "refundable_now": "0.00",
  "cancel_available": false,
  "cancel_before": "2026-08-25T10:30:15.000Z",
  "unresolved_refund_guaranteed_at": "2026-09-01T10:30:00.000Z",
  "unresolved_refund_amount": "0.50",
  "partial_refund_calculation": "confirmed_refund_ratio"
}

常见错误

状态	响应体	原因
400	{"error":"Missing parameter: order"}	缺少必填的 order 参数。响应为 400。
404	{"error":"Order not found"}	此账户没有匹配的订单。响应为 404。

普通订单

original_charge 是原始钱包扣款，refunded 是已记录的钱包入账。refund_pending=1 表示已确认的退款仍在等待钱包余额空间，refund_pending_amount 是尚未计入 refunded 的待入账金额。终态结果之前，refundable_now 表示依据 15 秒取消窗口或固定 7 天保证当前可享的额度。部分、取消或退款结算后，refundable_now 为 0；它不代表另一笔承诺入账。报价还会报告期限及已确认的部分退款结算。状态中的 charge 可能是保留金额或净额，因此请使用这些只读字段，不要相减状态值。

名称

类型

描述

key必需

string

你的 API key。

action必需

string

必须是字面字符串 "refund_quote"。

order必需

string

One account-owned numeric order ID.

请求示例

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

cURLJavaScriptPythonPHP

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

<?php
$body = http_build_query([
    'key' => 'YOUR_API_KEY',
    'action' => 'refund_quote',
    '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));

响应示例

{
  "order": 7001,
  "kind": "order",
  "status": "In progress",
  "status_key": "in_progress",
  "currency": "USD",
  "original_charge": "0.50",
  "refunded": "0.00",
  "refund_pending": 0,
  "refund_pending_amount": "0.00",
  "refundable_now": "0.00",
  "cancel_available": false,
  "cancel_before": "2026-08-25T10:30:15.000Z",
  "unresolved_refund_guaranteed_at": "2026-09-01T10:30:00.000Z",
  "unresolved_refund_amount": "0.50",
  "partial_refund_calculation": "confirmed_refund_ratio"
}

状态

响应体

原因

400

{"error":"Missing parameter: order"}

缺少必填的 order 参数。响应为 400。

404

{"error":"Order not found"}

此账户没有匹配的订单。响应为 404。

普通订单