Мультичейн-платежи в криптовалюте
Принимайте USDT и другие криптовалюты через API или готовую кассу на платформе. Каждому заказу выделяется адрес приёма и точная сумма в криптовалюте к оплате; после перевода плательщика платформа подтверждает поступление в блокчейне и отправляет подписанный результат на ваш URL обратного вызова. Используйте адреса, хранящиеся на платформе, или импортируйте адреса, приватные ключи от которых храните вы сами.
Два способа хранения адресов
В одном аккаунте можно использовать адреса обоих типов. Они различаются тем, у кого приватный ключ, куда сначала поступают деньги и когда взимается комиссия.
- Приватный ключ: Хранение на платформе: Создаётся платформой и хранится в зашифрованном виде; Самостоятельное хранение: Хранится у вас; платформа его не сохраняет
- Куда поступают деньги: Хранение на платформе: Сначала на адрес приёма, затем, после сбора на платформу, в ваши доступные для вывода активы; Самостоятельное хранение: Прямо на ваш адрес; платформа их не собирает
- Комиссия: Хранение на платформе: Удерживается из собранной суммы в момент сбора; Самостоятельное хранение: Списывается с баланса аккаунта при оплате каждого заказа
- Как распоряжаться деньгами: Хранение на платформе: Вывод на внешний адрес или перевод на баланс аккаунта; Самостоятельное хранение: Они в вашем собственном кошельке; переводите их когда угодно
- Откуда берутся адреса: Хранение на платформе: Получите их из пула адресов платформы в консоли или включите автоматическую выдачу; Самостоятельное хранение: Импортируйте их в консоли и подпишите проверочное сообщение кошельком каждого адреса, чтобы подтвердить, что он ваш; до 100 на сеть
- Учтите: Хранение на платформе: Перед выводом средства должны быть собраны, и у каждого токена есть минимальная сумма вывода; Самостоятельное хранение: Поддерживаются только сети, отмеченные в таблице сетей как доступные для импорта; пока баланс аккаунта ниже 0, эти адреса не принимают новые заказы
Возможности
- API заказов: Ваш сервер передаёт номер вашего заказа, сумму, валюту цены и токен и получает адрес приёма, сумму в криптовалюте, QR-код и ссылку на платёжную страницу. Заказы можно запрашивать и закрывать. По умолчанию заказ действует 20 минут, максимум — 7 дней.
- Несколько заказов на одном адресе: Когда на одном адресе одновременно есть несколько неоплаченных заказов, платформа меняет последние цифры каждой суммы в криптовалюте, чтобы все они различались, и сопоставляет каждый платёж с заказом по сумме. Диапазон и направление корректировки настраиваются в консоли.
- Фиксированные адреса «один к одному»: Привяжите фиксированный адрес приёма к каждому пользователю вашей системы. Каждый раз, когда этот пользователь отправляет на него деньги, автоматически создаётся оплаченный заказ и отправляется обратный вызов. Подходит для пополнения счетов.
- Касса: К каждому заказу прилагается готовая платёжная страница. Можно также открыть собственную ссылку на кассу, где плательщики сами вводят сумму, — без написания кода. Название бренда, логотип, цвет темы и диапазон сумм настраиваются.
- Цены в фиатной валюте: Цены заказов можно указывать в USD, EUR, CNY, JPY и других фиатных валютах, а платформа рассчитывает сумму в криптовалюте по текущему курсу. Курсы обновляются примерно каждые 5 минут, и если курс получить не удаётся, заказ не создаётся.
- Подписанные обратные вызовы с повторами: Как только платёж поступает, результат заказа отправляется на ваш URL обратного вызова с подписью HMAC-SHA256; ответ 2xx считается успешной доставкой. Неудачные отправки повторяются через 30 секунд, 1 минуту, 2 минуты, 5 минут, а затем каждые 10 минут, до 10 раз; каждую отправку можно посмотреть в консоли.
- Сбор средств и вывод: Криптовалюту на адресах с хранением на платформе можно собирать автоматически при превышении заданного вами порога или вручную. После сбора выводите средства в консоли или через открытый API либо переводите их на баланс аккаунта.
- SDK и MCP: SDK с открытым исходным кодом для PHP, Node.js, Python и Go, включая проверку подписи обратных вызовов. ИИ-клиенты также могут запрашивать заказы, приложения, адреса и историю отправок через MCP.
Как начать
- Зарегистрируйтесь и откройте консоль приёма платежей: Достаточно аккаунта Tovanix. Отдельная заявка и документы компании не нужны.
- Создайте приложение: Получите app_id, app_key и секрет подписи обратных вызовов и укажите свой URL обратного вызова. Если нужны фиксированные адреса, включите в приложении режим «один к одному».
- Подготовьте адреса приёма: Получите адреса с хранением на платформе из пула адресов или импортируйте свои адреса и подтвердите их подписью.
- Создавайте заказы или делитесь кассой: Ваш сервер вызывает эндпоинт создания заказа и передаёт плательщику полученную платёжную страницу или адрес приёма. Без написания кода можно просто отправить ссылку на свою кассу.
- Обрабатывайте обратные вызовы и используйте средства: Проверьте подпись каждого обратного вызова, затем выполните поставку или зачислите средства пользователю. Средства на адресах с хранением на платформе после сбора можно вывести или перевести на баланс аккаунта.
Правила
- Суммы заказов указываются в фиатной валюте, не более двух знаков после запятой; без currency цена заказа указывается в китайских юанях (CNY).
- По умолчанию заказ действует 20 минут; параметром timeout срок можно увеличить до 7 дней. Неоплаченные заказы закрываются автоматически по истечении срока.
- Платёж считается успешным, и обратный вызов отправляется, только после того как наберётся число подтверждений, указанное в таблице сетей.
- Ответ 2xx на обратный вызов считается доставкой, неудачные отправки повторяются до 10 раз. Обрабатывайте обратные вызовы идемпотентно по out_order_id, так как один и тот же заказ может прийти больше одного раза.
- Комиссия за адреса самостоятельного хранения списывается с баланса аккаунта при каждом платеже; пока баланс ниже 0, эти адреса не принимают новые заказы, уже созданные заказы не затрагиваются, а после пополнения баланса приём возобновляется.
- Вывести можно только собранные средства из доступных для вывода активов, и у каждого токена есть минимальная сумма вывода. Если служба контроля рисков просит аккаунт подтвердить личность, вывод невозможен до завершения проверки.
Сети и токены
| Сеть | Токены | Подтверждений до зачисления | Адреса самостоятельного хранения |
|---|---|---|---|
| TRON | TRX / USDT | Блоков: 19 | Можно импортировать |
Когда платформа открывает новую сеть, она автоматически появляется здесь. Сети, которых нет в списке, пока нельзя использовать для приёма платежей.
Комиссии
- Адреса с хранением на платформе: 0.5% и выше
- Адреса самостоятельного хранения: 1.5% (Минимум $0.01 за заказ)
- Перевод на баланс аккаунта: Бесплатно
| Собрано в этом месяце | Ставка |
|---|---|
| $0 – $1,000 | 1.5% |
| $1,000 – $2,000 | 1.2% |
| $2,000 – $5,000 | 0.8% |
| $5,000 и выше | 0.5% |
Минимальная комиссия за сбор: 0.5 TRX (TRON), 1 USDT (TRON)
| Токен | Комиссия | Минимальный вывод |
|---|---|---|
| TRX (TRON) | 1 TRX | 3 TRX |
| USDT (TRON) | 1.5 USDT | 3 USDT |
Это стандартные комиссии. Если для вашего аккаунта задана индивидуальная ставка, действует ставка, указанная в консоли. Ставки и минимальные комиссии устанавливает платформа, и эта страница обновляется автоматически.
Часто задаваемые вопросы
Какие монеты можно принимать сейчас?
Те, что перечислены в таблице сетей и токенов на этой странице: это сети и токены, по которым можно создавать заказы в данный момент. Новые сети автоматически появляются в таблице, как только платформа их открывает; сети, которых там нет, пока использовать нельзя.
Хранение на платформе или самостоятельное хранение?
Выбирайте хранение на платформе, если не хотите управлять приватными ключами и вам нужен вывод или перевод на баланс аккаунта. Выбирайте самостоятельное хранение, если хотите, чтобы деньги шли прямо в ваш собственный кошелёк без участия платформы. Самостоятельное хранение работает только в сетях, отмеченных в таблице как доступные для импорта, а его комиссии списываются с баланса аккаунта, поэтому держите баланс на уровне 0 или выше. Оба типа адресов можно использовать в одном аккаунте.
Как именно рассчитывается комиссия?
Хранение на платформе: за каждый сбор взимается большее из двух значений — собранная сумма, умноженная на ставку уровня этого месяца, или минимальная комиссия токена за сбор; остальное поступает в доступные для вывода активы. Уровень этого месяца зависит от того, сколько вы уже собрали с начала месяца, и сбрасывается в следующем месяце. Самостоятельное хранение: за каждый оплаченный заказ комиссия равна сумме в криптовалюте, умноженной на ставку; она пересчитывается в USD и списывается с баланса аккаунта, с минимумом за заказ. Ставки и минимальные комиссии указаны в разделе «Комиссии» на этой странице.
Нужна ли верификация личности или компания?
Чтобы начать, не нужно предоставлять документы личности или компании: приложение можно создать сразу после регистрации. Если служба контроля рисков сочтёт аккаунт рискованным, от него могут потребовать пройти верификацию личности, и до её завершения вывод невозможен.
Кто платит сетевую комиссию?
Сетевую комиссию за свой перевод платит плательщик. Сетевые комиссии за сбор средств с адресов с хранением на платформе оплачивает платформа, с вас они не взимаются.
Как проверить обратный вызов?
Вычислите HMAC-SHA256 по параметрам обратного вызова с секретом подписи обратных вызовов приложения (или с app_key, если секрет не задан) тем же способом, что и при подписи запросов, и сравните результат с sign. Обратные вызовы содержат notify_id, sign_ts и nonce для защиты от повторов, а в SDK есть готовый метод проверки.
Можно ли принимать платежи без написания кода?
Да. Откройте кассу в консоли и отправьте ссылку плательщикам — они сами введут сумму и оплатят. Платежи отображаются в консоли в разделе заказов кассы.
Как вывести деньги?
Хранение на платформе: после сбора средства находятся в доступных для вывода активах; выводите их на внешний адрес в консоли (фиксированная комиссия за каждый токен) или через открытый API либо переводите на баланс аккаунта. Самостоятельное хранение: деньги уже в вашем собственном кошельке, и платформа к ним не прикасается.
Связанные страницы: Аренда энергии TRON · Верификация и риски транзакций · Виртуальные карты · Документация API · Использование мультичейн-платежей
Загрузка…