Как работает криптоплатёжный шлюз?
Криптоплатёжный шлюз находится между вашей страницей оплаты и блокчейном. Ваше приложение говорит: «возьми с этого клиента 25 долларов». Шлюз отвечает адресом, точной суммой в монетах и сроком, следит за сетью, пока платёж не поступит, и сообщает вашему бэкенду в момент подтверждения. Именно детали отличают шлюз, на котором можно строить бизнес, от шлюза, на котором вы незаметно теряете деньги.
Какую задачу на самом деле решает шлюз
Принимать криптовалюту без шлюза кажется простым делом: опубликуйте адрес кошелька и попросите людей переводить средства. На практике это сразу перестаёт работать. Вы не можете понять, какой из двенадцати входящих переводов относится к какому заказу. Вы не знаете, сколько стоила монета, когда клиент нажал «Оплатить». Вам приходится самим опрашивать ноду в каждой поддерживаемой сети, и так без конца. И ещё нужно решить, что делать, когда кто-то прислал на 4% меньше.
Криптоплатёжный шлюз берёт всё это на себя. Он выдаёт каждому заказу собственную платёжную инструкцию, фиксирует курс, следит за нужными сетями, применяет ваши правила для недоплат и переплат и передаёт вашему приложению один понятный сигнал: оплачено или не оплачено.
Шаг 1. Ваш бэкенд создаёт транзакцию
Всё начинается с одного вызова API с вашего сервера. Вы передаёте сумму в USD, которую хотите получить, монету и сеть, выбранные покупателем, и время, в течение которого окно оплаты остаётся открытым. В VisualPay это один POST-запрос:
curl -X POST 'https://visualpay.net/api/v1/merchant/transaction/create' \
-H 'x-api-key: YOUR_MERCHANT_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"currency_symbol": "USDT",
"network_code": "trc20",
"amount_usd": 25.5,
"ttl": 15,
"order_id": 1001
}'
В этом запросе два момента важнее, чем кажется. Во-первых, цена задаётся в USD, а не в криптовалюте, так что вашему каталогу не приходится считать в сатоши. Во-вторых, вызов идёт с вашего сервера и авторизуется секретным API-ключом. Он никогда не выполняется в браузере, потому что всё, что находится в браузере, может изменить тот, кто вам платит.
Шаг 2. Шлюз фиксирует курс
В ответе ваши 25,50 доллара пересчитаны в точную сумму в криптовалюте, и эта сумма зафиксирована. Это самая недооценённая часть платёжного шлюза. Пока клиент ищет приложение кошелька, курс меняется. Если бы сумма пересчитывалась в момент поступления, падение на 3% за десять минут оплаты шло бы прямо из вашей маржи.
Фиксация курса при создании означает, что сумма, которую просят отправить покупателя, и есть сумма, которая будет зачислена вам, что бы ни происходило на рынке за это время. Плата за это: срок действия. Фиксация действует только в пределах заданного вами времени жизни. Короткие окна (10–20 минут) снижают ваш риск, длинные удобнее покупателям, которым сначала нужно вывести средства с биржи. Если окно закрылось без оплаты, транзакция просто истекает, и никто ничего не платит.
Шаг 3. Покупатель получает платёжные инструкции
В ответе есть всё, что нужно покупателю: адрес для оплаты, точная сумма, сеть и трек-код, который стоит сохранить вместе с заказом. То, как вы распорядитесь этими данными, и отличает шлюз с редиректом от шлюза без редиректа.
Шлюз с редиректом отправляет покупателя на страницу оплаты на домене провайдера. Это быстро внедряется, но покупатель покидает ваш бренд в самый хрупкий момент покупки, а вы теряете контроль над вёрсткой, языком и аналитикой.
Шлюз без редиректа возвращает данные вам, и вы показываете их сами: на своей странице оплаты, на экране своего приложения или сообщением в диалоге с ботом. VisualPay по умолчанию работает именно так, но предлагает и готовую страницу оплаты на случай, если вы вообще не хотите делать интерфейс.
Шаг 4. Мониторинг блокчейна
Когда транзакция открыта, шлюз следит за сетью в ожидании перевода с этим адресом и суммой. Это та часть, которую действительно трудно поддерживать самостоятельно: нужен доступ к нодам или подписка на индексаторы для каждой принимаемой сети, обработка реорганизаций и учёт глубины подтверждений для каждой сети. Перевод USDT в TRC20 и перевод в ERC20 проходят с разной скоростью.
Обработать нужно три исхода, и серьёзный шлюз обрабатывает все три:
- Точная оплата. Простой случай. Транзакция переходит в статус «подтверждена».
- Переплата. Покупатель отправил больше, чем нужно. Платёж всё равно принимается и записывается как переплата, а не отклоняется по формальной причине.
- Недоплата. Покупатель отправил чуть меньше: кошелёк удержал комиссию или сумма была введена вручную. В VisualPay можно задать допуск на недоплату: в его пределах платёж всё равно проходит, а зачисляемая сумма пересчитывается от фактически поступившей, и заказ не срывается из-за пары центов.
Шаг 5. Ваше приложение получает уведомление
Когда платёж подтверждён, шлюз вызывает ваш вебхук. Именно на этот сигнал должен реагировать бэкенд: отметить заказ оплаченным, выдать лицензионный ключ, отправить товар. VisualPay отправляет вебхук при создании транзакции и ещё один, когда её статус становится финальным, и принимает только HTTPS-адреса.
Одно правило стоит повесить на стену: никогда не выполняйте заказ только на основании данных из браузера. Если вы используете callback-редирект, чтобы вернуть покупателя на страницу успеха, считайте это исключительно удобством для пользователя. Прежде чем отдать что-то ценное, дождитесь вебхука или сами вызовите метод статуса и подтвердите состояние на сервере. Открыть URL страницы успеха вручную может кто угодно.
Шаг 6. Выплата
Наконец, деньги должны дойти до вас. Здесь шлюзы различаются сильнее всего, и у этого выбора есть реальные последствия.
Кастодиальный шлюз получает средства на свои кошельки, показывает вам баланс и выплачивает позже, обычно после заявки на вывод и ожидания. Всё это время ваша выручка остаётся долговой распиской на чужом балансе.
Некастодиальный шлюз выплачивает на кошелёк, который вы уже контролируете. В VisualPay при создании мерчанта вы указываете собственный адрес для каждой монеты и сети. Как только баланс по сети превышает порог выплаты, перевод запускается автоматически и обычно приходит меньше чем за минуту, а единственное удержание составляет сетевая комиссия самого блокчейна. Нет формы вывода и периода удержания, потому что ничего не удерживается.
Сколько это стоит
Большинство шлюзов берёт процент с каждого успешного платежа. Различается всё, что вокруг этой цифры: плата за подключение, месячные минимумы, комиссии за выплату и ставки, зависящие от объёма.
VisualPay берёт один фиксированный процент с каждой подтверждённой транзакции и больше ничего: без платы за подключение, абонентской платы, комиссии за выплату и ступеней по объёму. Вы также решаете, какая сторона берёт комиссию на себя: переложите её на покупателя, и счёт увеличится так, чтобы заказ зачислился вам полностью, или оставьте её на своём мерчанте, и она будет удержана из выплаты. Счета, которые истекли без оплаты или были отменены, ничего не стоят, потому что средства не переводились.
Общая картина
Весь цикл выглядит так: создать транзакцию, зафиксировать курс, показать покупателю, что отправить, следить за сетью, уведомить бэкенд, выплатить на ваш кошелёк. Хороший криптоплатёжный шлюз делает пять из этих шести шагов незаметными и даёт вам явный контроль над шестым.
Сравнивая провайдеров, спросите, фиксируется ли курс при создании, можно ли показать шаг оплаты в собственном интерфейсе, что происходит при недоплате и на чей кошелёк попадают деньги. Эти ответы скажут больше, чем процент в рекламе.
Начните принимать USDT и USDC уже сегодня
Начните без KYC, оставьте оплату на своём сайте и получайте средства на собственный кошелёк. Регистрация и первый мерчант бесплатны.