Подключение криптоплатежей к WooCommerce и Shopify
Если у вас уже есть магазин на WooCommerce или Shopify, добавление криптовалюты не требует переделки. Это новый способ оплаты рядом с уже имеющимися, и подключить его можно только двумя путями: установить плагин и вставить API-ключ либо вызывать REST API шлюза из собственного кода. Правильный выбор зависит не столько от ваших технических навыков, сколько от того, какую часть оформления заказа вы хотите контролировать.
Сначала решите, зачем вам это
Криптовалюта редко заменяет карты. Её стоит добавить, если верно хотя бы одно из условий ниже, и можно не добавлять, если не верно ни одно:
- Вы продаёте клиентам из регионов, где приём карт ненадёжен или дорог.
- Вы продаёте цифровые товары, и мошеннические чарджбэки обходятся вам в реальные деньги. Платежи в блокчейне нельзя отменить.
- У ваших клиентов уже есть стейблкоины, и они просят принимать их к оплате.
- Вам нужен способ оплаты, который не зависит от отношений с одним эквайером.
Ясная причина подсказывает и то, сколько сил стоит вложить в интеграцию. «Просят несколько клиентов» указывает на плагин. «Так платит треть нашего рынка» оправдывает полноценную разработку.
Путь 1. Плагин
На готовой платформе самый быстрый путь: плагин VisualPay для неё. Вы устанавливаете его, вставляете API-ключ мерчанта, выбираете принимаемые монеты и сети, и криптовалюта появляется среди вариантов оплаты. Без программирования.
Это правильный выбор, если у вас стандартный магазин, оформление заказа в теме близко к исходному и вы хотите запустить криптоплатежи на этой неделе, а не в этом квартале.
Настройка по порядку:
- Создайте аккаунт VisualPay и включите двухфакторную аутентификацию. Без неё нельзя создать мерчанта.
- Создайте мерчанта и укажите собственный адрес кошелька для каждой монеты и сети, которые собираетесь принимать. Туда будут приходить выплаты.
- Скопируйте API-ключ мерчанта со страницы его данных в панели.
- Установите плагин в магазине и вставьте ключ.
- Выберите монеты и сети и задайте, кто берёт на себя комиссию за платёж.
- Прежде чем объявлять о запуске, оформите небольшой реальный заказ от начала до конца.
Путь 2. Прямая работа с API
Если у вас headless-витрина, сильно доработанное оформление заказа или магазин лишь частично находится на платформе, прямой вызов API даёт полный контроль. Это один POST для создания транзакции и один вебхук, чтобы узнать об оплате.
POST https://visualpay.net/api/v1/merchant/transaction/create
x-api-key: YOUR_MERCHANT_API_KEY
Content-Type: application/json
{
"currency_symbol": "USDT",
"network_code": "trc20",
"amount_usd": 149.00,
"ttl": 30,
"order_id": 10432,
"email": "buyer@example.com",
"callback_url": "https://yourstore.com/checkout/crypto/return"
}
В ответе вы получаете платёжный адрес, точную сумму в криптовалюте и трек-код. Поскольку ничто не заставляет делать редирект, эти данные можно показать внутри собственного шага оформления заказа: та же тема, тот же домен, тот же язык. Сохраните трек-код вместе с заказом, с этого момента по нему вы работаете с платежом.
Это правильный выбор, если вы хотите, чтобы шаг с криптовалютой выглядел как остальное оформление заказа, если ваш процесс заказа плохо укладывается в платёжную абстракцию платформы или если вы уже привыкли поддерживать адрес для вебхуков.
Сопоставление статусов платежа и заказа
Именно здесь интеграции чаще всего дают сбой, поэтому стоит быть точным. У криптотранзакции есть статусы, которые магазин сам не понимает, так что определите соответствие заранее:
- Ожидает: счёт открыт и не оплачен. Держите заказ на удержании. Не резервируйте дефицитный товар бессрочно: время жизни счёта подскажет, когда его освободить.
- Подтверждён: оплачен и проведён в блокчейне. Переведите заказ в обработку или в выполненные и исполните его. Это единственный статус, который должен запускать исполнение.
- Переплата: платёж принят, получено больше, чем требовалось. Считайте заказ оплаченным и примените свои правила к излишку: зачисление на баланс в магазине или ручной возврат.
- Истёк: окно закрылось без оплаты. Отмените заказ и освободите товар. Ничего не списано.
- Отменён: покупатель сознательно отказался. Обработка та же, что для истёкшего.
Какой бы путь вы ни выбрали, правило из руководства по API остаётся в силе: callback-редирект, возвращающий покупателя на страницу успеха, служит удобству пользователя и не подтверждает оплату. Исполняйте заказ по вебхуку или по серверной проверке статуса. Никогда не делайте этого только потому, что браузер загрузил URL.
Выбор монет и сетей
Больше вариантов не значит лучше. Оформление заказа с четырнадцатью пунктами в выпадающем списке конвертирует хуже, чем с тремя, а каждая дополнительная сеть означает ещё один адрес кошелька, в котором нельзя ошибиться.
Большинству магазинов стоит начать с USDT в TRC20 (низкие комиссии, очень широко распространён), USDT в BEP20 (тоже дёшево, популярен у пользователей бирж) и USDC в ERC20, если ваши покупатели его предпочитают. Добавляйте остальное, только когда клиенты действительно попросят. В VisualPay монеты и сети включаются для каждого мерчанта, поэтому этот список меняется в настройках без переделки, а если у вас несколько витрин, у каждой может быть свой.
Цена и комиссия
VisualPay берёт один фиксированный процент с каждой успешной транзакции, без ежемесячной платы и комиссии за выплату. Вы выбираете, какая сторона берёт его на себя. Если переложить комиссию на покупателя, счёт увеличится так, чтобы заказ зачислился вам полностью, и учёт останется аккуратным. Если оставить её на мерчанте, покупатель увидит ожидаемую круглую сумму, что в потребительских магазинах обычно даёт лучшую конверсию.
Поскольку выплаты некастодиальные, подтверждённые платежи уходят прямо на указанные вами адреса кошельков, как только достигнут порог по сети, обычно в течение минуты, и удерживается только сетевая комиссия самого блокчейна. Между платежом и кошельком нет графика выплат и заявок на вывод.
Протестируйте перед запуском
Не пропускайте этот шаг и не ограничивайтесь проверкой удачного сценария:
- Оформите небольшой реальный заказ и оплатите его. Убедитесь, что заказ сам переходит в оплаченные и никому не нужно заходить в админку.
- Создайте заказ и дайте ему истечь без оплаты. Убедитесь, что заказ отменяется, а товар освобождается.
- Намеренно недоплатите небольшую сумму. Убедитесь, что поведение соответствует заданному допуску на недоплату.
- Проверьте, что письмо с подтверждением и страница заказа для клиента выглядят осмысленно для заказа с оплатой криптовалютой.
- Убедитесь, что выплата действительно пришла на ваш кошелёк, а не только что заказ отмечен оплаченным.
Какой путь выбрать
Выбирайте плагин, если ваш магазин близок к стандартному и вы хотите быстро запустить криптоплатежи с минимальной поддержкой. Выбирайте API, если оформление заказа нестандартное, у вас headless-архитектура или вам важно, чтобы покупатель оставался на вашем домене на шаге оплаты.
Оба пути ведут к одному шлюзу и к тем же кошелькам. Плагин меняет немного контроля на большую скорость, API меняет день работы на полный контроль над процессом. Ни один из них не закрывает вам дорогу к другому в будущем.
Начните принимать USDT и USDC уже сегодня
Начните без KYC, оставьте оплату на своём сайте и получайте средства на собственный кошелёк. Регистрация и первый мерчант бесплатны.