Кратко
Статический криптокошелек предоставляет клиенту постоянный ончейн-адрес для внесения депозитов, который не меняется от платежа к платежу. В отличие от разового инвойса, у которого есть платежное окно и который истекает, статический платежный канал позволяет пользователю отправлять повторные депозиты не ниже порога для выбранного токена и сети (minimum_deposit) без открытия нового чекаута. Каждый входящий депозит проходит AML-проверку; после подтверждения он зачисляется на баланс мерчанта, а вебхук сообщает о нем.
Статический криптокошелек закрепляет за каждым зарегистрированным пользователем постоянный ончейн-адрес для депозитов и превращает криптовалюту в привычный способ внести деньги на лицевой счет. В SaaS-платформах, iGaming-проектах, проп-трейдинге и телеграм-ботах новый инвойс на каждый депозит — лишний шаг для клиента. Статический адрес решает эту проблему: пользователь сохраняет реквизит в избранное и переводит средства напрямую с биржи или некастодиального кошелька в любое удобное время.
Переход на статические адреса меняет логику интеграции: вместо ожидания закрытия разового заказа сервер слушает непрерывный поток входящих транзакций. При подключении через REST API для мерчантов бэкенд генерирует адреса в нужных блокчейнах и обрабатывает асинхронные уведомления. Ниже разобран полный инженерный цикл работы со статическими адресами, специфика сетей и защита от грязного трафика.
Что такое статический криптокошелек?
Статический криптокошелек — это постоянный блокчейн-адрес, закрепленный за идентификатором пользователя в вашей базе данных и принимающий входящие транзакции без ограничения по времени. При регистрации клиента сервер обращается к API шлюза и получает постоянный адрес в сетях Tron или Ethereum. Этот реквизит остается неизменным: клиент может добавить его в белый список на бирже, настроить автоплатеж или переводить USDT частями.
В отличие от классического чекаута, здесь нет фиксированной суммы в фиате или таймера экспирации. Перед переводом проверьте minimum_deposit для выбранного токена и сети. Перевод ниже порога не зачисляется на канал и не возвращается автоматически. После AML-проверки и подтверждений сети депозит зачисляется на баланс мерчанта, а вебхук передает данные для обновления счета пользователя.
По своей логике эта модель полностью повторяет виртуальные банковские счета (vIBAN) в финтехе. Как необанк выдает клиенту персональный номер счета для входящих межбанковских переводов, так и криптопроцессинг выдает постоянный адрес для стейблкоинов.
Чем статические кошельки отличаются от разовых инвойсов?
Разовые инвойсы создаются под конкретный заказ, тогда как статические кошельки привязаны к профилю клиента. В классическом интернет-магазине с готовой платежной формой инвойс создается под конкретный заказ, с платежным окном и обратным отсчетом. Если покупатель не оплатил его до закрытия окна, инвойс истекает.
Статические кошельки полностью исключают проблему просроченных счетов. У адреса нет срока жизни: он остается активным до тех пор, пока мерчант явно не заблокирует его через метод /v1/payment-channels/{id}/block (возобновить прием депозитов можно через /unblock). Кроме того, в разовом инвойсе с ценой в фиате курс фиксируется, когда плательщик подтверждает актив и сеть. В статическом канале нет заказа, который нужно пересчитывать: каждый депозит зачисляется в фактически полученном токене за вычетом комиссии по тарифу, зафиксированному при привязке депозита к каналу.
Для сервисов с постоянными клиентами статические адреса убирают чекаут из повторных депозитов. Активному пользователю не нужно каждый раз открывать новый чекаут — достаточно один раз скопировать адрес и переводить средства прямо из кошелька или с биржевого аккаунта.
Зачем SaaS и гемблингу персональные адреса депозита?
Платформы с высокой активностью пользователей отказываются от разовых счетов из-за неизбежных задержек на этапе оплаты. В онлайн-играх и беттинге игроку нужно внести депозит прямо во время сессии, не покидая интерфейс приложения. В облачных сервисах и SaaS-бизнесе компании оплачивают потребление серверных мощностей или API-лимитов по факту расхода, где счета выставляются в фоновом режиме.
Сравните два пользовательских сценария:
- Трение при разовом инвойсе: Пользователь нажимает «Внести депозит», вводит сумму $100, переходит на платежную страницу, сканирует QR-код, пока не кончился обратный отсчет, отправляет перевод и ждет подтверждений сети.
- Бесшовный перевод на статический кошелек: Пользователь открывает личный кабинет, один раз копирует свой персональный адрес 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):
- Проверка в сети: Как только входящий перевод виден в блокчейне, адрес отправителя проверяется по этим источникам: TRM Labs, Binance AML, AMLBot, PureFi и база провайдера проверки.
- Чистые депозиты подтверждаются автоматически: Если риск в норме, депозит подтверждается как обычно, зачисляется на доступный баланс мерчанта, а на ваш сервер уходит стандартный вебхук.
- Рискованные депозиты удерживаются: Если депозит не прошел проверку или проверка не дала результата, он получает статус
Held for review. На баланс мерчанта ничего не зачисляется, вебхук о подтверждении не отправляется, а мерчант получает уведомление в кабинете.
Проверка не заменяет ваши собственные обязанности мерчанта по AML и санкциям, а удержанный депозит не обязательно будет разблокирован.
Сетевые комиссии и консолидация: кто платит за сбор депозитов со статических адресов
Частый вопрос — кто несет расходы на сбор мелких депозитов с тысяч отдельных адресов.
Сетевую комиссию за отправку депозита платит кошелек клиента. Сетевые расходы на прием и консолидацию депозитов Paymos берет на себя и не берет с мерчанта отдельную комиссию за перевод или свип. Сетевые комиссии устанавливает каждая сеть, и они меняются вместе с загрузкой, поэтому фиксированной суммы нет.
Если собирать средства самостоятельно, каждому адресу придется оплачивать собственный перевод на консолидацию, и сбор очень мелкого депозита может обойтись дороже самого депозита. В Paymos для каждой пары токена и сети действует актуальный minimum_deposit, а перевод ниже него не зачисляется на канал (см. раздел про API выше).
Подробнее о структуре защиты горячих кошельков и контроле рисков читайте в обзоре безопасности горячих кошельков и руководстве по инвойсам.
| Характеристика | Статический кошелек (Канал) | Динамический инвойс |
|---|---|---|
| Срок жизни адреса | Бессрочный (многократное использование) | Платежное окно с обратным отсчетом |
| Ожидаемая сумма | Не ниже порога (minimum_deposit) | Фиксированная сумма заказа; курс фиксируется, когда плательщик подтверждает актив и сеть |
| Основные сценарии | SaaS-балансы, iGaming, проп-трейдинг, биржи | Корзина интернет-магазина, разовые покупки |
| События вебхуков | payment_channel.deposit.confirmed | invoice.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, дождитесь актуальной суммы.
Когда НЕ стоит использовать статических криптокошельков
- Если вы продаете физические товары в интернет-магазине с бронированием остатков на складе — используйте динамические инвойсы с таймером обратного отсчета.
- Если вам требуется строгая привязка одного платежа к разовому гостевому заказу без регистрации пользователя.
- Если на стороне вашего сервера нет обработчика вебхуков для приема асинхронных событий депозита.
- Если архитектура требует полной анонимизации каждого перевода без повторного использования ончейн-адреса.
Источники
Последняя проверка: 7 нояб. 2026 г.


