Перейти к содержимому

Статические криптокошельки: как закрепить постоянный адрес депозита за каждым клиентом

6 нояб. 2026 г. 8 мин чтения Paymos Tech Paymos Tech
Иллюстрация статических криптокошельков и постоянных платежных каналов

Кратко

Статический криптокошелек предоставляет клиенту постоянный ончейн-адрес для внесения депозитов, который не меняется от платежа к платежу. В отличие от разового инвойса, у которого есть платежное окно и который истекает, статический платежный канал позволяет пользователю отправлять повторные депозиты не ниже порога для выбранного токена и сети (minimum_deposit) без открытия нового чекаута. Каждый входящий депозит проходит AML-проверку; после подтверждения он зачисляется на баланс мерчанта, а вебхук сообщает о нем.

Статический криптокошелек закрепляет за каждым зарегистрированным пользователем постоянный ончейн-адрес для депозитов и превращает криптовалюту в привычный способ внести деньги на лицевой счет. В SaaS-платформах, iGaming-проектах, проп-трейдинге и телеграм-ботах новый инвойс на каждый депозит — лишний шаг для клиента. Статический адрес решает эту проблему: пользователь сохраняет реквизит в избранное и переводит средства напрямую с биржи или некастодиального кошелька в любое удобное время.

Переход на статические адреса меняет логику интеграции: вместо ожидания закрытия разового заказа сервер слушает непрерывный поток входящих транзакций. При подключении через REST API для мерчантов бэкенд генерирует адреса в нужных блокчейнах и обрабатывает асинхронные уведомления. Ниже разобран полный инженерный цикл работы со статическими адресами, специфика сетей и защита от грязного трафика.

Что такое статический криптокошелек?

Статический криптокошелек — это постоянный блокчейн-адрес, закрепленный за идентификатором пользователя в вашей базе данных и принимающий входящие транзакции без ограничения по времени. При регистрации клиента сервер обращается к API шлюза и получает постоянный адрес в сетях Tron или Ethereum. Этот реквизит остается неизменным: клиент может добавить его в белый список на бирже, настроить автоплатеж или переводить USDT частями.

В отличие от классического чекаута, здесь нет фиксированной суммы в фиате или таймера экспирации. Перед переводом проверьте minimum_deposit для выбранного токена и сети. Перевод ниже порога не зачисляется на канал и не возвращается автоматически. После AML-проверки и подтверждений сети депозит зачисляется на баланс мерчанта, а вебхук передает данные для обновления счета пользователя.

По своей логике эта модель полностью повторяет виртуальные банковские счета (vIBAN) в финтехе. Как необанк выдает клиенту персональный номер счета для входящих межбанковских переводов, так и криптопроцессинг выдает постоянный адрес для стейблкоинов.

Чем статические кошельки отличаются от разовых инвойсов?

Разовые инвойсы создаются под конкретный заказ, тогда как статические кошельки привязаны к профилю клиента. В классическом интернет-магазине с готовой платежной формой инвойс создается под конкретный заказ, с платежным окном и обратным отсчетом. Если покупатель не оплатил его до закрытия окна, инвойс истекает.

Статические кошельки полностью исключают проблему просроченных счетов. У адреса нет срока жизни: он остается активным до тех пор, пока мерчант явно не заблокирует его через метод /v1/payment-channels/{id}/block (возобновить прием депозитов можно через /unblock). Кроме того, в разовом инвойсе с ценой в фиате курс фиксируется, когда плательщик подтверждает актив и сеть. В статическом канале нет заказа, который нужно пересчитывать: каждый депозит зачисляется в фактически полученном токене за вычетом комиссии по тарифу, зафиксированному при привязке депозита к каналу.

Для сервисов с постоянными клиентами статические адреса убирают чекаут из повторных депозитов. Активному пользователю не нужно каждый раз открывать новый чекаут — достаточно один раз скопировать адрес и переводить средства прямо из кошелька или с биржевого аккаунта.

Зачем SaaS и гемблингу персональные адреса депозита?

Платформы с высокой активностью пользователей отказываются от разовых счетов из-за неизбежных задержек на этапе оплаты. В онлайн-играх и беттинге игроку нужно внести депозит прямо во время сессии, не покидая интерфейс приложения. В облачных сервисах и SaaS-бизнесе компании оплачивают потребление серверных мощностей или API-лимитов по факту расхода, где счета выставляются в фоновом режиме.

Сравните два пользовательских сценария:

  1. Трение при разовом инвойсе: Пользователь нажимает «Внести депозит», вводит сумму $100, переходит на платежную страницу, сканирует QR-код, пока не кончился обратный отсчет, отправляет перевод и ждет подтверждений сети.
  2. Бесшовный перевод на статический кошелек: Пользователь открывает личный кабинет, один раз копирует свой персональный адрес USDT-TRC20 и отправляет перевод напрямую из мобильного кошелька (не ниже минимального порога). Когда перевод подтвержден и прошел AML-проверку, вебхук о депозите приходит на ваш бэкенд, и тот зачисляет сумму на баланс пользователя.

Для моделей с длительным жизненным циклом клиента (LTV) такой подход превращает криптоплатежи в надежный расчетный рельс. Ознакомьтесь также с нашими руководствами по распределению комиссий эквайринга и прозрачным тарифам мерчанта.

Мультичейн: прием USDT в сетях TRC-20, ERC-20 и TON

Промышленный шлюз выдает одному клиенту адреса сразу в нескольких сетях. Клиенты держат USDT и другие стейблкоины в разных сетях — Tron (TRC-20), Ethereum (ERC-20), TON, — поэтому платформе, которая принимает депозиты, часто нужны адреса в нескольких из них, и при этом учет по пользователю не должен дробиться.

Когда вы создаете канал, Paymos готовит адреса для депозитов в поддерживаемых сетях. Подготовка занимает какое-то время, поэтому показывайте адрес только после того, как канал сообщит, что он готов (см. раздел про API ниже). На экране депозита адреса можно собрать в одном месте:

  • USDT (Tron TRC-20): Поддерживается в сети Tron; перед отправкой проверьте актуальную минимальную сумму.
  • USDT / USDC (Ethereum ERC-20): Оба актива поддерживаются в Ethereum.
  • USDT (TON): Используйте адрес TON, полученный для канала.
  • USDT / USDC (Arbitrum, BSC, Polygon): Оба актива поддерживаются в этих сетях. В Base поддерживается только USDC.

В какой бы сети клиент ни отправил перевод, подтвержденный депозит зачисляется на баланс мерчанта в том же активе. Чтобы принимать депозиты, вашему бэкенду не нужно держать газ в каждой сети или поднимать собственную блокчейн-инфраструктуру.

Интеграция через REST API: создание каналов и прием вебхуков

Подключение статических адресов состоит из двух базовых шагов: генерации платежного канала и настройки обработчика входящих вебхуков.

1. Создание платежного канала для пользователя

Сервер мерчанта отправляет идемпотентный запрос POST на конечную точку /v1/payment-channels, передавая уникальный внутренний ID пользователя в параметре external_id:

Подпишите запрос ключом Payment по схеме HMAC-SHA256. В заголовках ниже указаны шаблоны для ID ключа, текущего Unix-времени и подписи в Base64. Строка для подписи — timestamp\nMETHOD\npath\nquery\nbodyHash, где bodyHash — SHA-256 точного тела запроса в шестнадцатеричном виде со строчными буквами. Поля разделяются переводами строки LF.

POST /v1/payment-channels HTTP/1.1
Host: api.paymos.io
Authorization: HMAC-SHA256 {api_key_id}:{base64_signature}
X-Request-Timestamp: {unix_seconds}
Content-Type: application/json

{
  "project_id": "prj_xFukZuAJZR06pLVBh3uwzv",
  "external_id": "usr_991824"
}

Первый запрос возвращает HTTP 201 Created. Повтор с теми же project_id и external_id в том же окружении возвращает существующий канал с HTTP 200 OK. Новый канал в production создается со статусом provisioning, пока без адресов:

{
  "id": "pc_2QhKZv6mRt9WdA3nYpLbXf",
  "project_id": "prj_xFukZuAJZR06pLVBh3uwzv",
  "external_id": "usr_991824",
  "status": "provisioning",
  "is_accepting_payments": false,
  "is_fully_provisioned": false,
  "is_test": false,
  "applied_fee_percent": 1,
  "customer_fee_percent": 0,
  "networks": [
    {
      "network": "TRC20",
      "status": "provisioning",
      "tokens": [
        {
          "symbol": "USDT",
          "minimum_deposit": "1.00"
        }
      ]
    }
  ],
  "created_at": 1767225600,
  "updated_at": 1767225600
}

Проверяйте готовность через GET /v1/payment-channels/{id}. Показывайте адрес сети, когда is_accepting_payments равно true, сеть имеет статус active, а массив tokens не пуст. Рядом с адресом укажите актуальный minimum_deposit для выбранного токена и проверьте его перед отправкой; сумма в примере условная. Если значение отсутствует или равно null, дождитесь актуальной суммы. Перевод ниже порога не зачисляется на канал и не возвращается автоматически. Подробнее — в описании канала.

2. Обработка входящего депозита по вебхуку

После AML-проверки и необходимых подтверждений сети приходит вебхук payment_channel.deposit.confirmed с данными зачисленного депозита:

{
  "event_id": "evt_J7EEYeL9pZJukfj2c5OQ44",
  "event_type": "payment_channel.deposit.confirmed",
  "version": 1,
  "occurred_at": 1767225930,
  "data": {
    "id": "pcd_8ScRvL4jNq2XkB7mTfZdWu",
    "payment_channel_id": "pc_2QhKZv6mRt9WdA3nYpLbXf",
    "project_id": "prj_xFukZuAJZR06pLVBh3uwzv",
    "payment_channel_external_id": "usr_991824",
    "status": "confirmed",
    "is_final": true,
    "is_test": false,
    "currency": "USDT",
    "network": "TRC20",
    "chain_id": 728126428,
    "contract_address": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",
    "gross": "100",
    "fee": "1",
    "net": "99",
    "applied_fee_percent": 1,
    "customer_fee_percent": 0,
    "tx_hash": "9f4c1b7e30ad52c8ef6a1d84b0c39f27a5e6d138f4b90c72ae51d63b8407fc25",
    "transfer_id": "9f4c1b7e30ad52c8ef6a1d84b0c39f27a5e6d138f4b90c72ae51d63b8407fc25:41a614f803b6fd780986a42c78ec9c7f77e6ded13c:41c9f6a2b7d0138e54ca3b91f6072ed48a5c1e93b7:0",
    "source_address": "TQiBwkXtUUNygicvHJVVDCDKyVFr2YNTey",
    "destination_address": "TN3W4H6rK2ce4vX9YnFQHwKENnHjoxb3m9",
    "block_height": 68421905,
    "first_included_block_timestamp": 1767225900,
    "explorer_url": "https://tronscan.org/#/transaction/9f4c1b7e30ad52c8ef6a1d84b0c39f27a5e6d138f4b90c72ae51d63b8407fc25",
    "created_at": 1767225870,
    "updated_at": 1767225930,
    "confirmed_at": 1767225930
  }
}

Проверяйте подпись по исходному телу запроса согласно инструкции. Зачисляйте пользователю data.net в одной транзакции с проверкой уникальности data.id — идентификатора депозита с префиксом pcd_. event_id используйте для учета попыток доставки: разные получатели могут получить разные ID событий для одного депозита. Подробнее — об идемпотентности вебхуков.

Автоматический AML-мониторинг входящих депозитов

Статический кошелек принимает переводы с любых сторонних адресов, поэтому автоматическая проверка входящих переводов важна. В разовом чекауте мерчант имеет дело с плательщиком, который сам открыл оплату, а на постоянный адрес перевод может отправить кто угодно.

Чтобы защитить мерчанта, Paymos автоматически проверяет входящие переводы (KYT):

  1. Проверка в сети: Как только входящий перевод виден в блокчейне, адрес отправителя проверяется по этим источникам: TRM Labs, Binance AML, AMLBot, PureFi и база провайдера проверки.
  2. Чистые депозиты подтверждаются автоматически: Если риск в норме, депозит подтверждается как обычно, зачисляется на доступный баланс мерчанта, а на ваш сервер уходит стандартный вебхук.
  3. Рискованные депозиты удерживаются: Если депозит не прошел проверку или проверка не дала результата, он получает статус Held for review. На баланс мерчанта ничего не зачисляется, вебхук о подтверждении не отправляется, а мерчант получает уведомление в кабинете.

Проверка не заменяет ваши собственные обязанности мерчанта по AML и санкциям, а удержанный депозит не обязательно будет разблокирован.

Сетевые комиссии и консолидация: кто платит за сбор депозитов со статических адресов

Частый вопрос — кто несет расходы на сбор мелких депозитов с тысяч отдельных адресов.

Сетевую комиссию за отправку депозита платит кошелек клиента. Сетевые расходы на прием и консолидацию депозитов Paymos берет на себя и не берет с мерчанта отдельную комиссию за перевод или свип. Сетевые комиссии устанавливает каждая сеть, и они меняются вместе с загрузкой, поэтому фиксированной суммы нет.

Если собирать средства самостоятельно, каждому адресу придется оплачивать собственный перевод на консолидацию, и сбор очень мелкого депозита может обойтись дороже самого депозита. В Paymos для каждой пары токена и сети действует актуальный minimum_deposit, а перевод ниже него не зачисляется на канал (см. раздел про API выше).

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

Сравнение статических каналов и разовых криптоинвойсов (ноябрь 2026)
ХарактеристикаСтатический кошелек (Канал)Динамический инвойс
Срок жизни адресаБессрочный (многократное использование)Платежное окно с обратным отсчетом
Ожидаемая суммаНе ниже порога (minimum_deposit)Фиксированная сумма заказа; курс фиксируется, когда плательщик подтверждает актив и сеть
Основные сценарииSaaS-балансы, iGaming, проп-трейдинг, биржиКорзина интернет-магазина, разовые покупки
События вебхуковpayment_channel.deposit.confirmedinvoice.paid / invoice.expired
Генерация адресаОдин раз при регистрации клиентаОдин раз на инвойс, когда плательщик подтверждает актив и сеть
Сетевые расходы на приемБерет на себя PaymosБерет на себя Paymos

Частые вопросы

Чем статический кошелек отличается от обычного инвойса?

Обычный инвойс создается под один заказ, с фиксированной суммой и платежным окном; когда окно закрывается, инвойс истекает. Статический кошелек (платежный канал) закрепляет за клиентом многоразовый адрес без платежного окна, который принимает депозиты не ниже порога для выбранного токена и сети (minimum_deposit) в фоновом режиме.

Можно ли отправлять USDT с разных сетей на один канал?

Да. При создании платежного канала шлюз формирует постоянные адреса под каждую поддерживаемую сеть (Tron TRC-20, Ethereum ERC-20, TON, BSC), привязанные к единому external_id клиента в вашей системе.

Как система понимает, какой именно пользователь внес депозит?

Каждый статический адрес однозначно привязан к external_id клиента в базе мерчанта. При поступлении блока процессинг отправляет вебхук, в котором указан этот ID, сумма зачисления и хэш транзакции.

Являются ли статические кошельки кастодиальными?

В Paymos платежные каналы работают по кастодиальной модели: ключи подписи хранит Paymos, а подтвержденные депозиты зачисляются на баланс мерчанта во внутреннем учете.

Что произойдет, если сумма депозита меньше минимальной?

Минимальная сумма minimum_deposit зависит от токена и сети и обновляется при запросе канала. Проверьте ее перед отправкой: перевод ниже порога не зачисляется на канал и не возвращается автоматически. Если значение отсутствует или равно null, дождитесь актуальной суммы.

Когда НЕ стоит использовать статических криптокошельков

  • Если вы продаете физические товары в интернет-магазине с бронированием остатков на складе — используйте динамические инвойсы с таймером обратного отсчета.
  • Если вам требуется строгая привязка одного платежа к разовому гостевому заказу без регистрации пользователя.
  • Если на стороне вашего сервера нет обработчика вебхуков для приема асинхронных событий депозита.
  • Если архитектура требует полной анонимизации каждого перевода без повторного использования ончейн-адреса.

Источники

  1. 1. API Paymos: создание платежного канала

Последняя проверка: 7 нояб. 2026 г.

#static-wallet#payment-channels#usdt#deposit-address#rest-api
Поделиться