Как подключить оплату криптовалютой в интернет-магазине: чек-лист запуска для WooCommerce, OpenCart, PrestaShop и Magento

Чтобы принимать криптовалюту в магазине на WooCommerce, OpenCart, PrestaShop или Magento, установите плагин CryptoLike для своей платформы, подключите его API-ключом, который умеет только создавать и читать платежи, и зарегистрируйте его адрес вебхука в кабинете. Это занимает минуты. А чтобы запуск прошёл гладко, заранее решите, какие монеты предлагать, сколько времени давать на оплату, что делать с недоплатами и поздними платежами и как оформлять возвраты, — и один раз проверьте каждый из этих случаев. Этот чек-лист проводит через всё по порядку. Если провайдер ещё не выбран, начните с 10 вопросов, как выбрать криптопроцессинг.

#Короткий чек-лист

Каждый пункт разобран ниже в отдельном разделе. Распечатайте список или перенесите его в задачу на запуск.

1. Плагин для вашей платформы и версии установлен и включён.
2. В плагине сохранён API-ключ только с правами create_invoice и read; «Проверить соединение» отвечает «Соединение установлено».
3. Адрес вебхука плагина добавлен в кабинете как эндпоинт со всеми событиями invoice.*, а его секрет — в плагине.
4. Валюта магазина включена для платежей в вашем аккаунте.
5. Выбраны монеты, режим страницы оплаты и срок оплаты.
6. Каждому состоянию платежа соответствует понятный команде статус заказа, включая статус для ручной проверки.
7. Поддержка знает, что делать с недоплатой, поздним платежом и переплатой и как оформить возврат.
8. Работает сверка раз в 15 минут.
9. Тесты пройдены, установлены боевой ключ и URL API по умолчанию.

#1. Выберите плагин для своей платформы

У CryptoLike есть плагины для четырёх CMS, и все работают по одному контракту: один платёж на заказ, статус заказа меняется по подписанным вебхукам, раз в 15 минут проверка догоняет пропущенные события, а в логах нет секретов и данных покупателей. Отличаются версии, адрес, на который приходит вебхук, и то, как запускается 15-минутная проверка.

Куда приходит вебхук (полный адрес показывают настройки плагина) и где плагин пишет лог:

• WooCommerce: /wp-json/cryptolike/v1/webhook; лог — WooCommerce → Статус → Журналы, источник cryptolike.
• OpenCart 3.0: index.php?route=extension/payment/cryptolike/callback; OpenCart 4.0: index.php?route=extension/cryptolike/payment/cryptolike.callback; лог — system/storage/logs/cryptolike.log.
• PrestaShop: /module/cryptolike/webhook; лог — Расширенные параметры → Журналы, объект Cryptolike.
• Magento 2: /cryptolike/webhook/, для каждого представления магазина; лог — var/log/cryptolike.log.

Версии — по документации каждого плагина на 24.09.2026. Магазину на Хорошоп плагин не нужен: см. подключение Хорошоп. Магазин на собственном коде работает через API — см. гайд как принимать криптовалюту на сайте.

#2. Подключите аккаунт: ключ и вебхук

Плагину нужны два секрета из кабинета CryptoLike: API-ключ, чтобы создавать платежи, и секрет эндпоинта вебхуков, чтобы проверять то, что CryptoLike присылает в ответ. В плагине оба только для записи: после сохранения их больше не показывают.

• API-ключ. В разделе Разработчикам → API-ключи создайте ключ с двумя правами: create_invoice и read. Магазину никогда не нужно право withdraw. Если у веб-сервера постоянный IP, добавьте его в белый список IP ключа.
• Эндпоинт вебхуков. Скопируйте адрес вебхука из настроек плагина, добавьте его в кабинете в Разработчикам → Вебхуки → Добавить эндпоинт со всеми событиями invoice.* и вставьте секрет эндпоинта в плагин. Без включённого эндпоинта магазин не примет ни одного криптозаказа: CryptoLike отклоняет платёж с адресом вебхука, пока в аккаунте нет включённого эндпоинта, а все четыре плагина скрывают способ оплаты, пока секрет не сохранён.
• Доступность. Магазин должен отвечать по https:// из интернета. Плагины режима обслуживания, «скоро открытие» и файрволы должны пропускать путь вебхука; редиректы CryptoLike не выполняет.

Нажмите Проверить соединение: плагин ответит «Соединение установлено: доступно валют — N.» Если он пишет «Не удалось соединиться» с кодом auth.invalid_key или auth.invalid_signature, неверен ID ключа или секрет; код auth.ip_not_allowed значит, что в белом списке IP ключа нет вашего сервера. Как устроены подписи — в гайде проверка подписи вебхуков.

#3. Проверьте валюту магазина

Плагин создаёт каждый платёж в валюте заказа, а CryptoLike пересчитывает её в монету, которую выбрал покупатель, по курсу, зафиксированному до срока платежа. USD, EUR, UAH, GBP и CAD включены для каждого аккаунта по умолчанию. В другой валюте платёж создать не получится: при оформлении заказа покупатель увидит, что оплата криптовалютой для этой валюты недоступна, и просьбу выбрать другой способ оплаты. В PrestaShop и Magento заказ к этому моменту уже создан и остаётся в ожидании оплаты.

Сумма в криптовалюте — это сумма заказа по рыночному курсу без спреда конвертации, а комиссия платформы — 0,8 % по стандартным ставкам, с минимумом для каждого актива, — списывается с вас при подтверждении платежа: плагины не перекладывают её на покупателя. Как считается сумма — в статье цена в долларах, оплата в криптовалюте; ставки — на странице тарифов.

#4. Выберите монеты, режим страницы и срок оплаты

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

• Монеты. По умолчанию покупатель выбирает монету на странице оплаты CryptoLike из включённых в вашем аккаунте. WooCommerce, OpenCart и PrestaShop умеют показывать список монет прямо в оформлении заказа магазина. Обычно начинают с USDT в сети TRON, а биткоин и USDT в Ethereum добавляют, если просят покупатели. Полный список — в каталоге монет.
• Режим страницы оплаты. Отправить покупателя на страницу оплаты CryptoLike или встроить её в страницу подтверждения заказа. Для встраивания добавьте адрес магазина в кабинете: Настройки → Интеграция → Разрешённые origin.
• Срок оплаты. Пустое поле — значение аккаунта по умолчанию, 30 минут, если его не меняли. Больший срок удобен покупателям, которые сначала покупают монеты на бирже; меньший ограничивает движение курса для волатильных монет.

Выберите и то, что происходит по истечении срока: отменить заказ или оставить его в ожидании, чтобы покупатель мог начать новую оплату через «Оплатить заказ».

#5. Сопоставьте состояния платежа и статусы заказа

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

Magento для ручной проверки использует собственное состояние Payment Review с кнопками Accept и Deny; заказ Magento, который уже был отменён, остаётся отменённым с комментарием, потому что Magento не умеет его открыть заново. Подробности по каждой платформе — на страницах интеграций.

#6. Договоритесь о недоплатах, поздних платежах и возвратах

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

• Недоплата. По умолчанию недостача до 0,5 % суммы считается оплатой, так что частичным платёж остаётся только при большей недостаче. Покупатель видит, сколько не хватает, и может доплатить на тот же адрес до конца срока. После срока: отгрузить за полученную сумму, запросить остаток новым платежом или вернуть деньги.
• Поздний платёж. Деньги уже на вашем балансе, заказ на ручной проверке. Спросите покупателя, нужен ли ему ещё заказ.
• Переплата. Заказ оплачен; рассчитайтесь с покупателем за излишек — верните его или засчитайте в следующий заказ.
• Возврат. Перевод в блокчейне нельзя отозвать, а плагины возвраты не делают. Попросите у покупателя адрес и сеть и отправьте выплату из кабинета; оценка покажет комиссии до подтверждения.

Каждый случай со статусами и вебхуками разобран в статье недоплата, переплата и поздний платёж. Для возвратов внесите постоянные адреса в белый список и включите второе подтверждение крупных сумм — см. гайд защита криптовыплат.

#7. Убедитесь, что работает сверка раз в 15 минут

Вебхуки — основной канал, но в момент их прихода магазин может быть недоступен или закрыт. Поэтому каждый плагин раз в 15 минут перечитывает открытые платежи за последние 7 дней, и заказ догоняет нужный статус, даже если вебхук так и не дошёл. В WooCommerce это делает WP-Cron; на сайтах с DISABLE_WP_CRON вызывайте WP-Cron из системного cron. В OpenCart и PrestaShop добавьте URL сверки плагина в cron вашего сервера. В Magento должен работать cron самой Magento.

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

#8. Пройдите тесты и запускайтесь

Проверьте каждый случай один раз — до того, как на него наткнутся покупатели. Тестовому режиму в плагине нужны две вещи: ключ ck_test_ и тестовый URL API в настройке URL API — его подскажет поддержка CryptoLike; с URL по умолчанию проверка соединения завершится ошибкой auth.test_key. Тогда плагин работает с тестовыми ключами и тестовыми сетями и показывает на оформлении заказа пометку «Тестовый режим». Тестовые монеты ничего не стоят, их может прислать поддержка CryptoLike. Сам плагин не примет боевой ключ в тестовом режиме и тестовый — в боевом. Завершите небольшим реальным заказом в той монете, которую ждёте чаще всего. Чем тестовое окружение отличается от боевого и какие ошибки их путают — в инструкции тестовые платежи до запуска.

Когда всё прошло, выключите тестовый режим, верните URL API по умолчанию, вставьте боевой ключ и оформите первый настоящий заказ. Тот же процесс со стороны бизнеса описан на странице криптовалюта для интернет-магазина.

#Вопросы и ответы

#Какие права API-ключа нужны плагину магазина?

Два: create_invoice, чтобы создавать платёж на каждый заказ, и read, чтобы проверять платежи и список валют. Право withdraw магазину не нужно никогда. Если IP веб-сервера постоянный, ограничьте им ключ — тогда утёкший ключ нельзя будет использовать с другого адреса.

#Плагин сам регистрирует вебхук?

Нет. Плагин показывает свой адрес вебхука; вы добавляете его в кабинете CryptoLike в разделе Разработчикам → Вебхуки как эндпоинт со всеми событиями invoice.* и вставляете секрет этого эндпоинта в плагин. До этого магазин не примет ни одного криптозаказа: все четыре плагина скрывают способ оплаты без секрета, а CryptoLike отклоняет платёж с адресом вебхука, пока в аккаунте нет включённого эндпоинта.

#Можно ли принимать оплату в любой валюте магазина?

Валюта магазина должна быть из тех, что принимает CryptoLike: USD, EUR, UAH, GBP или CAD, все включены по умолчанию. В другой валюте платёж по заказу создать не получится: при оформлении покупатель увидит, что оплата криптовалютой для этой валюты недоступна. Чтобы попросить другую валюту, напишите в поддержку: валюту добавляем, только когда её курс дают два независимых источника.

#Как вернуть деньги за заказ, оплаченный криптовалютой?

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

#Что будет, если магазин недоступен в момент подтверждения платежа?

CryptoLike повторяет вебхук около 31 часа, а плагин ещё и перечитывает открытые платежи раз в 15 минут. Когда магазин снова заработает, заказ перейдёт в нужный статус без ручной работы — при условии, что задача сверки запущена.