Перейти к основному содержимому

Выводы (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_usdtstringдаСумма в USDT
wallet_addressstringдаАдрес кошелька получателя
networkstringдаСеть (например TRC-20)
idempotency_keystringнет в кабинете, да при вызове по 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"
}

Ошибки​

КодСообщение
400terminal_id is required
400idempotency_key is required (при вызове по API-ключу)
403Создание вывода недоступно по API-ключу: для кассы он не включён
400insufficient balance
409max 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-ключу доступно всегда и не зависит от права создавать вывод.