Skip to main content
Обычный депозит — одноразовый: адрес живёт до оплаты и закрывается. Статический адрес выдаётся клиенту навсегда (пополнение баланса, «мой кошелёк для депозитов»): платформа следит за ним постоянно, и каждая входящая транзакция превращается в отдельный депозит — с обычными статусами, вебхуками deposit.* и сметанием на hot-кошелёк. Вы получаете ту же модель, что и у одноразовых депозитов, просто платежей на адресе много.
Для memo-сетей (TON, XRP) статический адрес = общий приёмный адрес + постоянный memo клиента. Клиент обязан указывать memo при каждом переводе — иначе платёж не будет привязан.

​
Эндпоинты

Все запросы — с HMAC-подписью (см. Аутентификация).

​
Выпустить адрес

​
string
required
Код актива (USDT_TRC20, TRX, USDT_TON, …).
​
string
required
Ваш идентификатор владельца адреса (клиент/аккаунт). Уникален в рамках сайта: повторный запрос с тем же orderId вернёт тот же адрес, а не создаст новый. Не может совпадать с orderId обычного депозита (409 DUPLICATE_ORDER_ID).
​
string
Метка для админки и вебхуков (до 255 символов).
​
string
UUID системного кошелька-получателя свипа (active, та же сеть).
​
string
1.4.0. Webhook-URL для всех платежей на этот адрес (вместо callback_url сайта).

​
Как приходят платежи

  1. Клиент отправляет любую сумму на адрес (сумма не фиксируется: expectedAmount дочернего депозита = 0, «принять любую»).
  2. Платформа замечает транзакцию и создаёт дочерний депозит с orderId вида customer-42#3 (порядковый номер платежа). Дальше — обычный поток: process → confirm_check → paid.
  3. На callback_url сайта приходят стандартные вебхуки deposit.tx_detected / deposit.confirmation / deposit.finalized. В объекте deposit есть поле staticAddress: { uuid, orderId, label } — по нему вы узнаёте, чей это баланс пополнять.
  4. Средства сметаются на hot-кошелёк по обычным правилам сметания.
Список платежей адреса — GET /v1/public/static-addresses/{uuid}/payments (те же объекты, что GET /v1/public/deposits/{uuid}, включая isFinal, amountUsd, transaction.fromAddress). Каждый платёж доступен и напрямую по своему uuid / orderId через эндпоинты депозитов.
Обрабатывайте вебхуки идемпотентно по deposit.uuid: у каждого платежа свой uuid, поэтому дубли доставки не приведут к двойному зачислению.

​
Поля ответа

​
string
active — адрес мониторится; disabled — приём остановлен (disable).
​
number
Число платежей (дочерних депозитов), включая незавершённые.
​
string
Сумма финализированных платежей (paid / paid_over / wrong_amount).
​
string | null
Время последней финализации.

​
Ограничения

  • Пыль ниже порога актива игнорируется (как у обычных депозитов).
  • Оператор может выключить выпуск новых статических адресов настройкой платформы — тогда POST вернёт 409 NETWORK_DISABLED; существующие адреса продолжают работать.
  • Статический адрес не истекает и не переходит в expired; остановить приём можно только через disable.