Выводы (Payouts)
Вывод накопленных USDT на внешний кошелёк.
По умолчанию вывод создаётся в личном кабинете: запросы требуют сессию пользователя, а API-ключ кассы создавать вывод не может. Вывод по API-ключу кассы включается отдельно для каждой кассы, чтобы включить его, напишите в поддержку или своему менеджеру (см. «Вывод по API-ключу»). Для выплат нескольким получателям на карты используйте отдельный сервис массовых выплат.
Создание вывода
POST /api/v1/payouts?terminal_id={terminalID}
Передайте terminal_id кассы в query и токен сессии в заголовке Authorization: Bearer ....
Запрос
{
"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 | нет в кабинете, да при вызове по API-ключу | Ключ идемпотентности, чтобы не создавать дубликаты |
Ответ 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 |
| 400 | idempotency_key is required (при вызове по API-ключу) |
| 403 | Создание вывода недоступно по API-ключу: для кассы он не включён |
| 400 | insufficient balance |
| 409 | max active payouts reached |
Вывод по API-ключу
Когда вывод по API включён для кассы, запрос отправляется с заголовками X-API-Key кассы и новым X-Nonce (см. аутентификацию), без токена сессии:
curl -X POST 'https://api.rollypay.io/api/v1/payouts?terminal_id=TERMINAL_ID' \
-H 'X-API-Key: YOUR_ROLLYPAY_API_KEY' \
-H 'X-Nonce: UNIQUE_NONCE' \
-H 'Content-Type: application/json' \
-d '{"amount_usdt":"50.00","wallet_address":"WALLET","network":"TRC-20","idempotency_key":"payout_20260223_001"}'
terminal_idобязателен и должен быть кассой самого ключа. Другой кассой этот ключ воспользоваться не может.idempotency_keyобязателен. Сохраните его до запроса; при тайм-ауте повторите запрос с тем же ключом и новымX-Nonce, повтор вернёт тот же вывод и не создаст второй.- Вывод по API-ключу уходит на любой указанный адрес без кода двухфа кторной аутентификации, поэтому храните ключ только на своём сервере и при подозрении на утечку сразу замените его в кабинете.
- Баланс, минимальные суммы, комиссии и лимиты те же, что в кабинете.
Статусы вывода
created ──→ pending ──→ processing ──→ completed
│
└──→ rejected
| Статус | Описание |
|---|---|
created | Заявка создана |
pending | Ожидает подтверждения администратором |
processing | Подтверждён, выполняется перевод в сети |
completed | Средства отправлены на кошелёк |
rejected | Заявка отклонена |
Список выводов
GET /api/v1/payouts?terminal_id={terminalID}
Возвращает список выводов по кассе. Чтение истории по API-ключу доступно всегда и не зависит от права создавать вывод.