Payouts API

Создать выплату

Отправка криптовалюты с баланса бизнес-кошелька мерчанта на внешний адрес.

POST https://api.speend.io/payout/create

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

Параметр	Тип	Обязателен	ОПИСАНИЕ
order_id	integer	да	Уникальный ID выплаты на стороне мерчанта. По нему потом сверяется статус и webhook
currency	string	да	Валюта выплаты, например USDT
network	string	да	Сеть, в которой отправляется транзакция, например TRON
amount	number	да	Сумма к выплате в указанной валюте. Минимум — эквивалент 7 USD (проверяется отдельно от формата числа)
address	string	да	Адрес получателя в выбранной сети
url_callback	string	нет	URL для webhook-уведомлений по этой выплате

{
  "order_id": 13,
  "currency": "USDT",
  "network": "SOL",
  "amount": 7,
  "address": "8Q3zsm*****tVUzasKQ"
}

{
  "uuid": "019f89aa-bfe9-7308-8e40-fb5b1345a5a4",
  "order_id": "13",
  "address": "8Q3zsm*****tVUzasKQ",
  "amount": "7",
  "currency": "USDT",
  "network": "SOL",
  "status": "SUCCESS",
  "is_final": true,
  "transaction_data": {
    "txid": "DgR9Tg*****AFe5nA9j6zJ6",
    "from": "FPoyLa*****iSHRMR1x",
    "to": "8Q3zsm*****tVUzasKQ",
    "coin": "USDT",
    "amount": "7"
  },
  "created_at": "2026-07-22 11:51:36"
}

Параметры ответа

Параметр	ОПИСАНИЕ
uuid	UUID выплаты
order_id	Ваш ID выплаты, переданный в запросе
address	Адрес получателя
amount	Сумма выплаты
currency	Валюта выплаты
network	Сеть, в которой отправлена транзакция
status	Статус выплаты — см. раздел «Статусы выплаты»
is_final	Признак финального статуса
transaction_data	Данные транзакции в блокчейне (см. таблицу ниже)
created_at	Дата и время создания выплаты

Объект transaction_data

Параметр	ОПИСАНИЕ
txid	Хэш транзакции в блокчейне
from	Адрес отправителя (кошелёк Speend, с которого ушла выплата)
to	Адрес получателя — совпадает с address из запроса
coin	Валюта транзакции
amount	Сумма, отправленная в блокчейн-транзакции

Идемпотентность

Ошибки 422

Ситуация	Сообщение
Не передано поле order_id (аналогично для currency, network, amount, address — все поля обязательны)	The order id field is required.
Передана валюта, не поддерживаемая для выплат	The selected currency is invalid.
Передана сеть, не поддерживаемая для выплат, либо не соответствующая указанной валюте	The selected network is invalid.
Комбинации currency + network не существует	currency with such network does not exist
Адрес находится в чёрном списке	address is black listed
Адрес не соответствует формату выбранной сети	address is invalid
Сумма выплаты в пересчёте на USD меньше 7	Amount is too low
На балансе мерчанта недостаточно средств для выплаты	insufficient balance
Сумма выплаты превышает лимит, разрешённый без подтверждения мерчанта	The withdrawal amount exceeds the maximum allowed without merchant approval. Please contact the merchant.

Статус выплаты

Получение текущего статуса и данных по ранее созданной выплате.

POST https://api.speend.io/payout/getStatus

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

Параметр	Тип	Обязателен	ОПИСАНИЕ
order_id	string	да	Ваш ID выплаты, переданный при создании

{
  "order_id": "13"
}

{
  "uuid": "019f89aa-bfe9-7308-8e40-fb5b1345a5a4",
  "order_id": "13",
  "address": "8Q3zsm*****tVUzasKQ",
  "amount": "7",
  "currency": "USDT",
  "network": "SOL",
  "status": "SUCCESS",
  "is_final": true,
  "transaction_data": {
    "txid": "DgR9Tg*****AFe5nA9j6zJ6",
    "from": "FPoyLa*****iSHRMR1x",
    "to": "8Q3zsm*****tVUzasKQ",
    "coin": "USDT",
    "amount": "7"
  },
  "created_at": "2026-07-22 11:51:36"
}

Параметры ответа

Параметры ответа полностью совпадает со схемой payout/create (см. предыдущий раздел).

Жизненный цикл статусов

Успешный сценарий:

REQUESTED
AWAITING_CONFIRMATION
ON_QUEUE
ON_QUEUE_CONVERSION
ON_NETWORK_QUEUE
SUCCESS

Альтернативные (неуспешные) исходы — возможны на любом из промежуточных этапов выше:

CANCELED
FAILED
AML_FAILED

Статус	Значение	is_final
REQUESTED	Выплата создана, запрос принят	false
AWAITING_CONFIRMATION	Ожидание подтверждения выплаты мерчантом (окно подтверждения в личном кабинете)	false
ON_QUEUE	Выплата принята в обработку и ожидает очереди	false
ON_QUEUE_CONVERSION	Стадия конвертации валют — топ-ап донора (кошелька-источника) через биржу	false
ON_NETWORK_QUEUE	Стадия сетевого перевода — транзакция отправляется on-chain	false
SUCCESS	Выплата успешно отправлена и подтверждена в блокчейне	true
CANCELED	Выплата отменена	true
FAILED	Выплата не удалась (ошибка на стадии обработки/отправки)	true
AML_FAILED	Выплата отклонена AML-проверкой (комплаенс-скоринг адреса получателя)	true

Ошибки 422

Ситуация	Сообщение
Не передано поле order_id	The order id field is required.
Значение order_id передано числом, а не строкой	The order id must be a string.
Значение order_id передано числом, а не строкой	Withdrawal not found.