Skip to main content

Создание трансфера

Перевод средств между терминалами мерчанта. Оба терминала должны принадлежать одному мерчанту.

Endpoint

POST /v1/transfers

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

ПараметрТипОбязательныйОписание
from_terminal_idstringДаID терминала-источника
to_terminal_idstringДаID терминала-получателя
amountnumberДаСумма перевода в USDT

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

curl -X POST https://api.settler.pw/api/v1/transfers \
-H "Content-Type: application/json" \
-H "X-Identity: your-api-key" \
-H "X-Signature: your-signature" \
-d '{
"from_terminal_id": "550e8400-e29b-41d4-a716-446655440000",
"to_terminal_id": "660f9500-f30c-52e5-b827-557766551111",
"amount": 500
}'

Ответ

{
"success": true,
"from_terminal_id": "550e8400-e29b-41d4-a716-446655440000",
"to_terminal_id": "660f9500-f30c-52e5-b827-557766551111",
"amount": 500,
"currency": "USDT"
}

Ошибки

КодHTTPОписание
TRF_001400Неверные параметры
TRF_002404Терминал не найден
TRF_003400Недостаточно средств на терминале-источнике
info

Трансфер выполняется атомарно — средства списываются с одного терминала и зачисляются на другой в одной транзакции. Комиссия не взимается.