← Блог
10 мин чтения
|
Опубликовано
|
Обновлено

Регулярные криптоплатежи: как построить и вести их

Регулярные криптоплатежи: эскроу, подписанные списания и счета на статический адрес, стандарты разрешений, вебхуки, сверка и форма 1099-DA.

Главы
C
Chaingateway Team
Эксперты по блокчейну

Проверил(а) Maurice Sobiera

Изометрическая схема архитектуры регулярных платежей

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

Какую схему выбрать?

В руководстве Stripe о регулярных криптоплатежах описаны основные схемы. Поскольку многие блокчейны не поддерживают нативные таймеры, регулярные платежи опираются на внешние триггеры и уровни автоматизации. В руководстве названы Chainlink Automation и Gelato для запуска выполнения контракта, а также Superfluid и Sablier для непрерывных потоков платежей.

СхемаКто запускает платёжГде лежат средстваЧто нужно
Выставление счёта на статический адресКлиент, каждый периодУ клиента, пока он не заплатитАдрес на клиента, вебхук, сверка
Предоплаченный эскроуПланировщик или контрактВ смарт-контрактеКонтракт, внешний триггер, аудит
Подписанные списанияПродавец, каждый циклУ клиента, до списанияКонтракт, проверяющий подписи, планировщик
Потоковая оплатаКонтракт, непрерывноВ потоковом контрактеКонтракт, пакетирование расчётов

Выставление счёта на статический адрес не требует контракта и проще всего в эксплуатации. Chaingateway выставляет счета своих подписок именно так: у каждого клиента есть статический платёжный адрес, сумма гибкая, а дата окончания подписки сдвигается в зависимости от полученной суммы. Описание есть в релизе New Payment Flow. Недостаток в том, что клиент должен действовать каждый период, поэтому продление зависит от напоминания, а не от автоматизации.

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

Как выставление счёта на статический адрес работает с вебхуками?

Вы создаёте один адрес на клиента, регистрируете для него вебхук и засчитываете подписку, когда приходит подходящий платёж. Вебхук ниже следит за адресом Tron на USDT. Поле reference несёт ID вашей подписки, поэтому уведомление можно сопоставить с аккаунтом:

Terminal window
curl -X POST https://app.chaingateway.io/api/v2/tron/webhooks \
-H "Authorization: Bearer $CHAINGATEWAY_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"to": "TWrTTVizHkF3LxTiWE9vCnhWC7CBpNXe22",
"contractaddress": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",
"type": "TRC20",
"url": "https://billing.example.com/hooks/payment",
"reference": "sub_20417"
}'

Уведомление содержит txid, from, to, contractaddress, amount, blocknumber и webhook_id. Ваш обработчик должен сделать пять вещей:

  1. Проверить заголовок X-Signature, который подписывает txid, после того как вы задали личный секрет.
  2. Найти подписку по webhook_id или адресу.
  3. Отклонить txid, который уже видели.
  4. Сравнить amount и токен со счётом и решить, что делать с недоплатами, переплатами и неверными токенами.
  5. Продлить период подписки и ответить кодом 2xx.

Проверьте единицы измерения amount платежом в тестовой сети, прежде чем писать логику ценообразования. Вебхуки не повторяются автоматически. Неудачное уведомление появляется в GET /api/v2/tron/webhooks/notifications/failed, и вы отправляете его заново через эндпоинт повтора. Остальное ловит ночное задание, которое сравнивает ожидаемые и полученные платежи. Подробнее об идемпотентности и тестировании см. руководство по вебхукам.

Какой токен и какую сеть выбрать?

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

Сети второго уровня (Layer 2) созданы для масштабирования Ethereum, и ethereum.org называет низкие комиссии среди их преимуществ. По данным документации Tron, в TRON работает самая большая сеть USDT TRC-20. Для этой цели Chaingateway поддерживает Ethereum, Arbitrum, Polygon, BNB Smart Chain и Tron, а также другие сети. У каждой сети своя модель комиссий, поэтому сначала протестируйте полный платёж и возврат в тестовой сети этой сети, с заголовком X-Network: testnet.

Что меняют стандарты разрешений для подписанных списаний?

Они ограничивают, как долго и на какую сумму контракт продавца может списывать средства. Обычное одобрение ERC-20 может быть безлимитным и бессрочным, поэтому скомпрометированный контракт продавца способен вывести весь баланс клиента. Три стандарта решают части этой задачи. Их статус различается, поэтому проверьте его, прежде чем на что-то полагаться:

СтандартЧто добавляетСтатус в репозитории EIP (5 ноября 2026 года)
ERC-2612Permit: одобрение подписанным сообщением, без отдельной транзакции одобренияФинальный
ERC-5827Расширение разрешения с автоматическим продлениемЗастой (Stagnant)
ERC-8255Истекающие одобрения токенов: по умолчанию одобрения истекают через ограниченный срокЧерновик

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

Как сделать регулярное выставление счетов безопасным?

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

На клиентов могут также нацеливаться с помощью подделки. Опубликуйте ваши платёжные адреса на одной статической странице и объясните клиентам, что никогда нельзя отправлять средства на адрес из письма или сообщения в чате. Настоящие потоки выставления счетов показывают адрес внутри вашего приложения.

Какие правила налоговой отчётности нужно знать?

Налоговая служба США (IRS) требует, чтобы брокеры отчитывались о продаже цифровых активов в форме 1099-DA, и в эту категорию могут попадать некоторые платёжные процессоры. Страница IRS о цифровых активах указывает, что отчётность применяется к операциям с 1 января 2025 года и что правила вводятся поэтапно. В число охваченных брокеров она включает процессоры платежей в цифровых активах (PDAP) и брокеров, которые получают во владение продаваемые активы. Считается ли ваш сервис брокером, зависит от хранения средств и от того, как они проходят, поэтому спросите налогового консультанта. Эта статья не является налоговой или юридической консультацией.

Для бухгалтерии фиксируйте три суммы по каждому платежу: сумма счёта в валюте выставления, полученная криптосумма и стоимость в вашей валюте отчётности на момент получения. Храните ID транзакции вместе с каждой записью.

Как выглядит разумный пилот?

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

Адреса, вебхуки и выплаты для такого пилота можно создать через блокчейн-API и вебхуки Chaingateway. В файле OpenAPI нет эндпоинтов для разрешений, планирования или произвольных вызовов контрактов, поэтому подписанным списаниям и эскроу нужны собственный контракт и планировщик. Тарифы начинаются от 49 € в месяц, а 7-дневный пробный период не требует карты и KYC. См. страницу цен.

Источники

Часто задаваемые вопросы

Может ли IRS видеть ваш криптокошелёк?

IRS не следит за кошельками напрямую. Она получает отчёты от брокеров, которые подают форму 1099-DA по операциям с цифровыми активами начиная с 2025 года. Если ваш бизнес или платформа, которой вы пользуетесь, подпадает под определение брокера, ваши операции появятся в этих отчётах.

Каковы недостатки регулярных криптоплатежей?

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

Как понять, что перед вами мошенник?

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

Какая криптоплатёжная система лучше для регулярных платежей?

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

Рекомендуем

Как мы пишем эти статьи

Готовы собрать это сами? Получите свой API-ключ — 7-дневный пробный период, без карты — или посмотрите API блокчейна для полного справочника по эндпоинтам.

C
Chaingateway Team
Эксперты по блокчейну

Команда Chaingateway стремится упростить интеграцию блокчейна для разработчиков по всему миру.