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

Создаёт запрос на вывод USDT на TRC-20 кошелёк.

Endpoint

POST /v1/withdrawals

Параметры запроса

Параметр	Тип	Обязательный	Описание
terminal_id	string	Да	ID терминала, с которого выводить
amount	number	Да	Сумма вывода в USDT
address	string	Да	Адрес TRC-20 кошелька
subtract_fee_from_amount	boolean	Нет	Вычесть комиссию из суммы (по умолчанию false)

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

curl -X POST https://api.settler.pw/api/v1/withdrawals \
  -H "Content-Type: application/json" \
  -H "X-Identity: your-api-key" \
  -H "X-Signature: your-signature" \
  -d '{
    "terminal_id": "550e8400-e29b-41d4-a716-446655440000",
    "amount": 100,
    "address": "TNPXDJcnLqNwPbTB6ux7k1fSgM2v7jetP9"
  }'

С вычетом комиссии из суммы

curl -X POST https://api.settler.pw/api/v1/withdrawals \
  -H "Content-Type: application/json" \
  -H "X-Identity: your-api-key" \
  -H "X-Signature: your-signature" \
  -d '{
    "terminal_id": "550e8400-e29b-41d4-a716-446655440000",
    "amount": 100,
    "address": "TNPXDJcnLqNwPbTB6ux7k1fSgM2v7jetP9",
    "subtract_fee_from_amount": true
  }'

При subtract_fee_from_amount: true комиссия вычитается из суммы. Например, при сумме 100 USDT и комиссии 5 USDT на кошелёк поступит 95 USDT.

info

Средства замораживаются на балансе указанного терминала. Для получения балансов терминалов используйте GET /v1/terminals.

Ответ

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "amount": 100,
  "fee": 5,
  "currency": "USDT",
  "address": "TNPXDJcnLqNwPbTB6ux7k1fSgM2v7jetP9",
  "tx_hash": null,
  "status": "pending",
  "created_at": "2026-01-30T12:00:00Z",
  "updated_at": "2026-01-30T12:00:00Z"
}

Поля ответа

Поле	Тип	Описание
id	string	ID вывода (UUID)
amount	number	Сумма вывода
fee	number	Комиссия
currency	string	Валюта (USDT)
address	string	Адрес кошелька
tx_hash	string	Хеш транзакции (после отправки)
status	string	Статус
created_at	string	Время создания
updated_at	string	Время обновления

Статусы

Статус	Описание
pending	Ожидает обработки
processing	В обработке
completed	Успешно отправлен
failed	Ошибка

Ошибки

Код	HTTP	Описание
WDR_001	400	Неверные параметры
WDR_002	400	Недостаточно средств