Get Deposit Address

POST /api/wallet/deposit

⚷ Bearer Token

Сгенерировать адрес для входящего депозита

Возвращает адрес для пополнения по указанной валюте + сети. Если адрес уже выдан — возвращает существующий (deposit-адрес reuse-able и не меняется между запросами).

Request body

Name	Type	Required	Description
`currency`	`string`	required	Тикер валюты: `USDT`, `BTC`, `ETH`, `LTC`, `KAS` и др.
`network`	`string`	required	Сеть: `TRC20`, `ERC20`, `BEP20`, `BTC`, `LTC`. Должна быть в списке `networks` для валюты.
`memo_required`	`boolean`	optional	Для XRP, XLM, EOS — сгенерировать уникальный memo/tag для идентификации.

Response

Responses

{
  "data": {
    "currency": "USDT",
    "network": "TRC20",
    "address": "TXYZabcdef0123456789ghijklmnop",
    "memo": null,
    "qr_code_url": "https://fin-os.io/api/wallet/deposit/qr/TXYZ...",
    "min_deposit": "1.000000",
    "max_deposit": null,
    "estimated_fee": "0.000000",
    "expires_at": null,
    "warning": "Отправляйте ТОЛЬКО USDT в сети TRC20 на этот адрес. Депозиты в других монетах или сетях будут потеряны."
  }
}

{
  "message": "Network not supported for this currency.",
  "errors": {
    "network": ["The selected network is invalid for USDT."]
  },
  "error_code": "VALIDATION_FAILED"
}

{
  "message": "KYC required for crypto deposits.",
  "error_code": "KYC_REQUIRED"
}

⊘

Сеть имеет значение

Депозит в неправильной сети (например, USDT-ERC20 на USDT-TRC20 адрес) — необратим. Finance OS не может восстановить такие средства без обращения в свою холодную поддержку (платная процедура, не всегда возможна).

QR-код

qr_code_url — endpoint возвращает PNG 512×512 с QR-кодом адреса (и memo, если есть). Удобно для мобильных приложений — пользователь сканирует камерой кошелька.

Webhook on deposit

Как только депозит обнаружен в mempool — Finance OS присылает webhook wallet.deposit.detected, а после подтверждения — wallet.deposit.confirmed. Подписка настраивается в ЛК. См. Webhooks.