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

> Что решить и проверить до того, как магазин начнёт принимать криптовалюту: плагин и версии, API-ключ, вебхук, монеты, срок оплаты, статусы заказов, возвраты и тесты.

Source: https://cryptolike.net/ru/blog/ecommerce-crypto-checklist
Published: 2026-09-24 · Updated: 2026-10-11 · Author: CryptoLike team

Главное:

- Установите плагин CryptoLike для своей платформы, дайте ему API-ключ только с правами create_invoice и read и добавьте его адрес вебхука как эндпоинт со всеми событиями invoice.*.
- До запуска решите: какие монеты предлагать, сколько времени даётся на оплату, какой статус заказа соответствует каждому состоянию платежа и кто разбирает недоплаты и поздние платежи.
- Возврат — это выплата из кабинета: договоритесь, как поддержка запрашивает у клиента адрес и сеть.
- Пройдите тесты — оплата, недоплата с доплатой, истечение срока, поздний платёж, двойной клик — и убедитесь, что работает сверка раз в 15 минут.

Чтобы принимать криптовалюту в магазине на WooCommerce, OpenCart, PrestaShop или Magento, установите плагин CryptoLike для своей платформы, подключите его API-ключом, который умеет только создавать и читать платежи, и зарегистрируйте его адрес вебхука в кабинете. Это занимает минуты. А чтобы запуск прошёл гладко, заранее решите, какие монеты предлагать, сколько времени давать на оплату, что делать с недоплатами и поздними платежами и как оформлять возвраты, — и один раз проверьте каждый из этих случаев. Этот чек-лист проводит через всё по порядку. Если провайдер ещё не выбран, начните с [10 вопросов, как выбрать криптопроцессинг](https://cryptolike.net/ru/blog/choose-crypto-payment-gateway).

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

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

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

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

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

| Платформа | Версии | Проверка раз в 15 минут |
|---|---|---|
| [WooCommerce](https://cryptolike.net/ru/integrations/woocommerce) | WordPress 6.1+, WooCommerce 7.0+, PHP 7.4–8.4; блочное и классическое оформление заказа | WP-Cron |
| [OpenCart](https://cryptolike.net/ru/integrations/opencart) | 3.0.x (PHP 7.4+) и 4.0.x (PHP 8.0–8.2); 4.1 не поддерживается | URL для cron вашего сервера |
| [PrestaShop](https://cryptolike.net/ru/integrations/prestashop) | 8.x, проверен на 8.1; заявленный минимум — 1.7.8 | URL для cron вашего сервера |
| [Magento 2](https://cryptolike.net/ru/integrations/magento) | 2.4.6+, PHP 8.1–8.4, оформление заказа Luma | Задача cron Magento `cryptolike_reconcile` |

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

- **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. Магазину на Хорошоп плагин не нужен: см. [подключение Хорошоп](https://cryptolike.net/ru/integrations/horoshop). Магазин на собственном коде работает через API — см. гайд [как принимать криптовалюту на сайте](https://cryptolike.net/ru/guides/accept-crypto-payments).

## 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 ключа нет вашего сервера. Как устроены подписи — в гайде [проверка подписи вебхуков](https://cryptolike.net/ru/guides/verify-crypto-payment-webhooks).

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

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

Сумма в криптовалюте — это сумма заказа по рыночному курсу без спреда конвертации, а комиссия платформы — 0,8 % по стандартным ставкам, с минимумом для каждого актива, — списывается с вас при подтверждении платежа: плагины не перекладывают её на покупателя. Как считается сумма — в статье [цена в долларах, оплата в криптовалюте](https://cryptolike.net/ru/blog/fiat-priced-crypto-payments); ставки — на странице [тарифов](https://cryptolike.net/ru/pricing).

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

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

- **Монеты.** По умолчанию покупатель выбирает монету на странице оплаты CryptoLike из включённых в вашем аккаунте. WooCommerce, OpenCart и PrestaShop умеют показывать список монет прямо в оформлении заказа магазина. Обычно начинают с [USDT в сети TRON](https://cryptolike.net/ru/coins/usdt-trc20), а биткоин и USDT в Ethereum добавляют, если просят покупатели. Полный список — в [каталоге монет](https://cryptolike.net/ru/coins).
- **Режим страницы оплаты.** Отправить покупателя на страницу оплаты CryptoLike или встроить её в страницу подтверждения заказа. Для встраивания добавьте адрес магазина в кабинете: **Настройки → Интеграция → Разрешённые origin**.
- **Срок оплаты.** Пустое поле — значение аккаунта по умолчанию, 30 минут, если его не меняли. Больший срок удобен покупателям, которые сначала покупают монеты на бирже; меньший ограничивает движение курса для волатильных монет.

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

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

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

| Платёж | Заказ (по умолчанию) | Кто действует |
|---|---|---|
| Создан | Ожидает оплаты | Никто |
| Перевод обнаружен | Без изменений, заметка с ID транзакции | Никто |
| Подтверждён (`paid`) | В обработке: склад, письма и отгрузка как обычно | Склад |
| Оплачено больше суммы заказа | В обработке, с заметкой об излишке | Поддержка: вернуть излишек или засчитать |
| Недоплата до срока | На удержании, заметка с недостающей суммой | Никто: покупатель доплачивает |
| Недоплата после срока, поздний платёж, второй платёж, отмена перевода | Статус ручной проверки | Решает поддержка |
| Срок истёк | Отменён или остаётся в ожидании | Никто |

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

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

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

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

Каждый случай со статусами и вебхуками разобран в статье [недоплата, переплата и поздний платёж](https://cryptolike.net/ru/blog/underpaid-crypto-payments). Для возвратов внесите постоянные адреса в белый список и включите второе подтверждение крупных сумм — см. гайд [защита криптовыплат](https://cryptolike.net/ru/guides/payout-whitelist-dual-approval).

## 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. Сам плагин не примет боевой ключ в тестовом режиме и тестовый — в боевом. Завершите небольшим реальным заказом в той монете, которую ждёте чаще всего. Чем тестовое окружение отличается от боевого и какие ошибки их путают — в инструкции [тестовые платежи до запуска](https://cryptolike.net/ru/guides/test-crypto-payments).

| Проверка | Ожидаемое состояние заказа |
|---|---|
| Оплатить точную сумму | В обработке после подтверждений; страница оплаты показывает «Платёж подтверждён.» |
| Оплатить часть, затем доплатить до срока | На удержании, затем В обработке |
| Дождаться истечения срока | Отменён или в ожидании (по настройке) |
| Оплатить после срока | Статус ручной проверки; деньги на балансе |
| Нажать «Оплатить» дважды, обновить страницу | Одна страница оплаты на заказ |
| Сломать вебхук (неверный секрет), затем исправить | Заказ догоняет статус в течение 15 минут |

Когда всё прошло, выключите тестовый режим, верните URL API по умолчанию, вставьте боевой ключ и оформите первый настоящий заказ. Тот же процесс со стороны бизнеса описан на странице [криптовалюта для интернет-магазина](https://cryptolike.net/ru/use-cases/online-stores).

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

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

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

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

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

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

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

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

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

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

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