Выводы (Payouts)

Вывод накопленных USDT на внешний кошелёк.

Создание вывода

POST /api/v1/payouts?terminal_id={terminalID}

Если используется аутентификация по API key, касса известна, можно передавать terminal_id в query или не передавать (подставится касса ключа).

Запрос

{
  "amount_usdt": "50.00",
  "wallet_address": "TJYkxBf0XG3P8nFHv1i9zNbeQ7oCF3qLzR",
  "network": "TRC-20",
  "idempotency_key": "payout_20260223_001"
}

Поле	Тип	Обязательное	Описание
amount_usdt	string	да	Сумма в USDT
wallet_address	string	да	Адрес кошелька получателя
network	string	да	Сеть (например TRC-20)
idempotency_key	string	нет	Ключ идемпотентности, чтобы не создавать дубликаты

Ответ 200 OK

{
  "id": "po_f47ac10b-58cc-4372-a567-0e02b2c3d479",
  "terminal_id": "d290f1ee-6c54-4b01-90e6-d701748f0851",
  "amount_usdt": "50.00",
  "wallet_address": "TJYkxBf0XG3P8nFHv1i9zNbeQ7oCF3qLzR",
  "network": "TRC-20",
  "status": "created",
  "idempotency_key": "payout_20260223_001",
  "created_at": "2026-02-23T14:00:00Z",
  "updated_at": "2026-02-23T14:00:00Z"
}

Ошибки

Код	Сообщение
400	terminal_id is required (если касса не выведена из API key)
400	insufficient balance
409	max active payouts reached

---

Статусы вывода

created ──→ pending ──→ processing ──→ completed
                │
                └──→ rejected

Статус	Описание
created	Заявка создана
pending	Ожидает подтверждения администратором
processing	Подтверждён, выполняется перевод в сети
completed	Средства отправлены на кошелёк
rejected	Заявка отклонена

---

Список выводов

GET /api/v1/payouts?terminal_id={terminalID}

Возвращает список выводов по кассе. При аутентификации по API key параметр terminal_id может быть опущен.