Перейти к основному содержанию
POST
Пополнить баланс платформы

Авторизации

tungo.session_token
string
cookie
обязательно

Сессия кабинета: cookie ставит вход через /v1/auth/* (Better Auth), браузер шлёт её сам — фронтенду кабинета ничего добавлять не нужно (fetch с credentials: 'include'). За HTTPS имя cookie — __Secure-tungo.session_token. Сессия кончилась — 401 authentication_error: отправить на вход.

Параметры пути

ws
string
обязательно

id организации (workspace), ws_… — из GET /v1/workspaces

Тело

application/json

Пополнение баланса платформы.

amount_tiyn
integer
обязательно

Сумма пополнения в тиынах (1 ₸ = 100 тиын). Границы суммы и дневной предел — настройка платформы platform.purchase

Требуемый диапазон: x >= 1
Пример:

1000000

idempotency_key
string
обязательно

Ключ повтора (8–200 знаков, например UUID): создайте один раз на нажатие «Пополнить»; повтор с тем же ключом не списывает второй раз

Required string length: 8 - 200
Пример:

"6f1c2b8e-0d4a-4c1e-9f3a-2b7d5e8a9c10"

Ответ

Платёж и баланс после него

Пополнение баланса платформы: платёж и баланс.

payment_id
string
обязательно

Платёж картой (pay_…)

status
enum<string>
обязательно

Состояние платежа: succeeded — деньги списаны, баланс пополнен; new / pending / authorized — идёт; requires_action — банк ждёт 3-D Secure; failed / cancelled — не прошёл

Доступные опции:
new,
pending,
requires_action,
authorized,
succeeded,
verified,
failed,
cancelled,
partially_refunded,
refunded
amount_tiyn
integer
обязательно

Сумма платежа в тиынах (1 ₸ = 100 тиын; показывать значение / 100 ₸)

balance_tiyn
integer
обязательно

Баланс платформы сейчас (пополнение входит, только если платёж уже прошёл) в тиынах (1 ₸ = 100 тиын; показывать значение / 100 ₸)