Заявки на выплату USDT

Клиент отправляет заявку через API. NUMUS резервирует сумму во внутреннем учёте, проверяет заявку и выполняет перевод вручную.

API не переводит USDT. В ядре нет кошелька, seed phrase, приватного ключа, подписи транзакции или отправки в блокчейн. Успешный ответ означает только, что заявка сохранена.

Последовательность

NUMUS согласует получателяКлиент получает beneficiaryRef. Это ссылка на реквизиты, а не адрес кошелька.
Клиент проверяет доступную суммуGET /api/withdrawal-balances/{storeID} возвращает доступно и уже зарезервировано.
Клиент создаёт заявкуPOST /api/withdrawal-requests резервирует сумму и возвращает статус REQUESTED.
NUMUS проверяет заявкуФинансовый сотрудник сверяет торговую точку, сумму и согласованный профиль получателя.
NUMUS выполняет перевод вручнуюПеревод выполняется вне processing. API не хранит ключи и не управляет кошельком.

Проверить доступную сумму

GET https://api.numus.online/api/withdrawal-balances/{storeID}

Метод подписывается ключом партнёра. Он возвращает внутренний учёт, а не баланс кошелька:

{
  "storeId": "store-001",
  "currency": "USDT",
  "availableUsdt": "500.000000",
  "reservedUsdt": "125.500000"
}

Создать заявку

POST https://api.numus.online/api/withdrawal-requests

POST /api/withdrawal-requests HTTP/1.1
Host: api.numus.online
Content-Type: application/json
Authorization: {подписанный JSON}
Idempotency-Key: payout-store-001-000001

{
  "storeId": "store-001",
  "amountUsdt": "125.500000",
  "beneficiaryRef": "beneficiary_01"
}

Поле	Правило
`storeId`	Торговая точка должна принадлежать авторизованному партнёру.
`amountUsdt`	Строка, до шести знаков после точки. Не переводите сумму через float.
`beneficiaryRef`	Идентификатор согласованного получателя, выданный NUMUS.
`Idempotency-Key`	16–128 символов. Новый ключ для новой заявки, тот же ключ для сетевого повтора.

Ответ 201 Created:

{
  "withdrawalRequestId": "0190c5ad-2f51-7b1d-9f2e-e0a01d8f9a21",
  "storeId": "store-001",
  "amountUsdt": "125.500000",
  "beneficiaryRef": "beneficiary_01",
  "status": "REQUESTED",
  "createdAt": "2026-07-24T17:40:00Z",
  "updatedAt": "2026-07-24T17:40:00Z"
}

REQUESTED означает: заявка принята и сумма зарезервирована. Этот статус не подтверждает перевод USDT.

Повтор запроса

тот же Idempotency-Key и то же тело возвращают исходную заявку;
тот же ключ с другой суммой или получателем возвращает 409;
при недостаточной доступной сумме запрос отклоняется, резерв не создаётся;
партнёр не может прочитать заявку или баланс чужой торговой точки.

Получить заявки

GET/api/withdrawal-requests/{requestID}
Одна заявка по идентификатору.

GET/api/withdrawal-requests?storeId=store-001&limit=50
Последние заявки партнёра.

Что не отправлять

Не передавайте адрес кошелька, мнемоническую фразу, приватный ключ, подписанную транзакцию или банковские реквизиты в beneficiaryRef, комментарии и другие поля API. Реквизиты получателя согласуются с NUMUS отдельно.