Баланс

Возвращает текущий подтверждённый баланс кошелька в USD. Каждый запрос читает последний завершённый баланс; обычные ограничения API продолжают действовать.

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

Требуется API-ключОграничение частоты (общий аккаунт + IP + действие)Тело: application/x-www-form-urlencoded

Параметры

Название	Тип	Описание
keyОбязательный	string	Ваш API-ключ.
actionОбязательный	string	Должно быть буквальной строкой «balance».

Пример запроса

Замените YOUR_API_KEY на ключ, сгенерированный на странице API в вашей панели.

cURLJavaScriptPythonPHP

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

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: "balance",
  }),
});

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

import requests

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

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

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

Пример ответа

{
  "balance": "47.32",
  "currency": "USD"
}

Распространённые ошибки

Статус	Тело	Причина
403	{"error":"Account suspended"}	Аккаунт неактивен.

О формате баланса

Всегда строка. API сериализует десятичный баланс как строку, чтобы представить субцентовые значения без округления JSON-чисел.

Только USD. Все расчёты ведутся в USD независимо от того, какую отображаемую валюту вы используете в панели.

Текущий подтверждённый баланс. Каждый запрос читает последнее завершённое состояние кошелька, поэтому успешное списание или возврат видны сразу.

Сверяйте после записей. Читайте action=balance после важных списаний, возвратов и других операций с кошельком, когда интеграции нужен последний зафиксированный баланс.

Баланс

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

Требуется API-ключОграничение частоты (общий аккаунт + IP + действие)Тело: application/x-www-form-urlencoded

Название

Тип

Описание

keyОбязательный

string

Ваш API-ключ.

actionОбязательный

string

Должно быть буквальной строкой «balance».

Пример запроса

Замените YOUR_API_KEY на ключ, сгенерированный на странице API в вашей панели.

cURLJavaScriptPythonPHP

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

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: "balance",
  }),
});

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

import requests

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

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

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

Статус

Тело

Причина

403

{"error":"Account suspended"}

Аккаунт неактивен.

О формате баланса

Только USD. Все расчёты ведутся в USD независимо от того, какую отображаемую валюту вы используете в панели.