# Как принимать криптовалюту на сайте: 4 способа

> Приём криптовалюты на сайте через CryptoLike: плагин CMS, API или SDK с виджетом, ссылка на оплату, коннектор Хорошоп. Шаги, сравнение и ошибки.

Source: https://cryptolike.net/ru/guides/accept-crypto-payments
Published: 2026-09-24 · Updated: 2026-10-11 · Author: CryptoLike team

Криптопроцессинг CryptoLike даёт сайту четыре способа принимать криптовалюту: плагин для WooCommerce, OpenCart, PrestaShop или Magento 2; REST API или SDK со страницей оплаты или встроенным виджетом; ссылку на оплату из кабинета или Telegram-бота; коннектор для Хорошоп. Любой путь заканчивается одинаково: подтверждённый платёж и статус, по которому можно действовать.

## Четыре способа в одной таблице

У CryptoLike за каждым способом приёма криптовалюты стоят одна и та же страница оплаты и одни и те же статусы платежа; различается только то, кто и что настраивает. Плагину CMS не нужен разработчик, API даёт команде полный контроль, ссылке на оплату не нужен сайт, а коннектор Хорошоп подключается из кабинета. Сроки — при зарегистрированном аккаунте и одном тестовом платеже.

| Способ | Для кого | Что нужно | Время до первого платежа | Как узнать результат |
|---|---|---|---|---|
| Плагин CMS | Магазины на WooCommerce, OpenCart 3/4, PrestaShop, Magento 2 | Доступ к админке магазина по https, API-ключ, вебхук-эндпоинт | 30–60 минут | Статус заказа меняется сам |
| API или SDK, страница оплаты или виджет | Команды со своим бэкендом: маркетплейсы, SaaS, приложения | Сервер, который хранит секрет, API-ключ, https-эндпоинт | Около 10 минут до тестового платежа, 1–3 дня до запуска | Подписанные вебхуки `invoice.*` или `GET /v1/invoices/{id}` |
| Ссылка на оплату | Фрилансеры, счета B2B, продажи в мессенджерах | Аккаунт в кабинете; по желанию Telegram-бот | 5 минут | Кабинет и сообщение в Telegram |
| Коннектор Хорошоп | Магазины на Хорошоп | Тариф с доступом к API, отдельный администратор, способ оплаты «Криптовалюта» | Около 15 минут | Заказ отмечается оплаченным; каждый шаг — в журнале синхронизации |

Загрузки и подробности по каждому способу — на [странице интеграций](https://cryptolike.net/ru/integrations), сценарии для магазинов — в разделе [криптовалюта для интернет-магазина](https://cryptolike.net/ru/use-cases/online-stores), для сервисов со своим бэкендом — [криптоплатежи для цифровых товаров и SaaS](https://cryptolike.net/ru/use-cases/digital-goods), для пополнения балансов — [пополнения на статические адреса](https://cryptolike.net/ru/use-cases/deposits). Пошаговый код для собственного бэкенда: [на PHP](https://cryptolike.net/ru/guides/accept-crypto-payments-php), [на Node.js](https://cryptolike.net/ru/guides/accept-crypto-payments-nodejs) и [на Python](https://cryptolike.net/ru/guides/accept-crypto-payments-python).

## Что подготовить

Для приёма криптовалюты через CryptoLike нужны аккаунт в кабинете, список активов, которые вы хотите принимать, и — для плагина или API — сайт на https. Верифицированный аккаунт (KYB) нужен только для выплат; платежи, ссылки на оплату, плагины и коннектор Хорошоп работают без него, так что начните верификацию заранее, если планируете выплаты. Тестируйте с тестовыми ключами (`ck_test_`) в тестовых сетях.

Доступные активы: Bitcoin, Litecoin, Ethereum с токенами USDT и USDC в ERC20, TRON с USDT в TRC20. Сеть и порог подтверждений каждого актива есть в `GET /v1/currencies` и на [странице активов](https://cryptolike.net/ru/coins). В разделе кабинета «Монеты» переключатель «Включена» подключает актив к аккаунту, а «Для инвойсов» решает, предлагают ли его платежи.

## 1. Выберите способ под то, как вы продаёте

Способ CryptoLike выбирают по тому, где покупатели платят сейчас. Магазин на WooCommerce, OpenCart, PrestaShop или Magento 2 ставит плагин; магазин на Хорошоп подключается в кабинете; сайт или приложение со своим бэкендом работает через API или SDK; бизнес без сайта отправляет ссылки на оплату. Все способы зачисляют деньги на один баланс.

Пока не решили? Создайте одну ссылку на оплату: за пять минут вы увидите страницу оплаты и статусы, которые увидят ваши покупатели.

## 2. Создайте тестовый API-ключ

CryptoLike узнаёт плагин или ваш сервер по API-ключу: в кабинете откройте «Разработчикам» → «API-ключи», создайте ключ с правами `create_invoice` и `read` и скопируйте секрет — он показывается один раз. Ключ с префиксом `ck_test_` работает с тестовыми сетями через тестовый адрес API, который даст поддержка CryptoLike (в основных сетях он получает `401 auth.test_key`); ссылкам на оплату и коннектору Хорошоп ключ не нужен вовсе.

Храните секрет на сервере, а не на веб-странице или в приложении. Потеряли его? Создайте новый ключ, переключите на него интеграцию и отзовите старый.

## 3. Подключите приём платежей

CryptoLike создаёт платёж одинаково в любом сценарии: сумма, валюта — USD, EUR, UAH, GBP или CAD либо тикер монеты — и номер вашего заказа дают платёж с `checkout_url`. Если актив не зафиксирован через `coin_id`, плательщик выбирает его на этой странице из монет, доступных для инвойсов, и у каждой видит ориентировочную сумму со знаком ≈; `allowed_coin_ids` или список монет в плагине сужает выбор для конкретного платежа. Курс фиксируется в момент выбора до конца срока платежа, а на экране видны сумма, сеть, адрес, QR-код и оставшееся время.

**Плагин CMS.** Загрузите архив для [WooCommerce](https://cryptolike.net/ru/integrations/woocommerce), [OpenCart](https://cryptolike.net/ru/integrations/opencart), [PrestaShop](https://cryptolike.net/ru/integrations/prestashop) или [Magento 2](https://cryptolike.net/ru/integrations/magento) в админке магазина, вставьте ID ключа и секрет и нажмите «Проверить подключение». Добавьте URL вебхука из плагина как эндпоинт в разделе «Разработчикам» → «Вебхуки» со всеми событиями `invoice.*` и вставьте секрет эндпоинта обратно в плагин: плагин передаёт `webhook_url` с каждым платежом, и без включённого эндпоинта платёж не создастся. Двойной клик или перезагрузка вернут открытый платёж заказа, а не создадут второй.

**API или SDK.** Ваш сервер вызывает `POST /v1/invoices` и отправляет покупателя на `checkout_url` — или оставляет его на вашей странице с [виджетом оплаты](https://cryptolike.net/ru/docs/widget). [SDK](https://cryptolike.net/ru/docs/sdk) для TypeScript, Python, Go и PHP подписывают запросы и добавляют `Idempotency-Key`; пока это пре-релиз, они ставятся из репозитория.

```ts
const invoice = await api.invoices.create(
  { amount: "10.50", currency: "USD", order_id: "A-1001" },
  "order-A-1001", // Idempotency-Key: повтор вернёт тот же платёж
);
// перенаправьте покупателя на invoice.checkout_url
```

**Ссылка на оплату.** В кабинете откройте «Инвойсы» → «Создать инвойс», укажите сумму, валюту и описание, затем скопируйте ссылку или отправьте её в мессенджер. В Telegram-боте то же делает команда `/invoice`. Подробнее — [ссылки на оплату](https://cryptolike.net/ru/use-cases/payment-links).

**Коннектор Хорошоп.** Хорошоп не принимает сторонние платёжные плагины, поэтому CryptoLike подключается к магазину через его API: создайте в Хорошоп отдельного администратора, добавьте способ оплаты «Криптовалюта» простого типа, затем в кабинете откройте «Интеграции» → [Хорошоп](https://cryptolike.net/ru/integrations/horoshop) и нажмите «Проверить». Ссылка на оплату приходит покупателю на e-mail примерно через минуту после заказа.

## 4. Получайте результат подписанным вебхуком

CryptoLike сообщает результат [вебхуком](https://cryptolike.net/ru/glossary/webhook) с подписью HMAC-SHA256: событие `invoice.paid` означает, что средства подтверждены и зачислены на ваш баланс. Эндпоинт отвечает 2xx за 10 секунд; неудачная доставка повторяется через 1 мин, 5 мин, 15 мин, 1 ч, 6 ч и 24 ч с тем же `event_id`, поэтому обрабатывайте каждое событие один раз.

Плагины и коннектор Хорошоп применяют события сами. При работе через API проверяйте [подпись вебхука](https://cryptolike.net/ru/glossary/webhook-signature) по сырому телу запроса — см. [проверку подписи вебхуков](https://cryptolike.net/ru/guides/verify-crypto-payment-webhooks) — и отгружайте по `paid`; остальные состояния описаны в [модели статусов](https://cryptolike.net/ru/docs#status-model). Обработчик отклоняет настоящие доставки? Скорее всего, в нём неверный секрет эндпоинта. Секрет показывается только один раз, поэтому выпустите новый в «Разработчикам» → «Вебхуки» и разверните его.

## 5. Проведите тестовый платёж и запускайтесь

Тестовые платежи CryptoLike идут в тестовых сетях: тестовые монеты ничего не стоят, и их может прислать поддержка CryptoLike; отправьте точную сумму на адрес со страницы оплаты и проследите, как статус меняется с `pending` на `paid`. Магазину на CMS пригодится полный [чек-лист запуска для интернет-магазина](https://cryptolike.net/ru/blog/ecommerce-crypto-checklist). Затем переключите плагин или сервер на боевой ключ и уберите тестовые ключи и тестовый адрес API из продакшен-конфигурации. Полная репетиция по всем статусам — в инструкции [как протестировать криптоплатежи](https://cryptolike.net/ru/guides/test-crypto-payments).

Один раз недоплатите намеренно больше чем на 0,5 %, чтобы увидеть `underpaid`, и дайте одному платежу истечь, чтобы увидеть `expired`. У Хорошоп нет песочницы: закажите дешёвый скрытый тестовый товар и оплатите небольшую сумму.

## Ошибки и что делать

CryptoLike возвращает любую ошибку API в одном формате: HTTP-статус, машиночитаемый `code`, `message` для человека и `details` с указанием проблемы. Ветвитесь по `code` и исправляйте то, на что указывает `details.field` или `details.reason`. Здесь — ошибки, которые чаще всего встречаются в новой интеграции; полный список — в [справочнике API](https://cryptolike.net/ru/docs/api).

| HTTP · code | Что произошло | Что делать |
|---|---|---|
| `400 validation_error`, поле `currency` | Валюта заказа не включена для вашего аккаунта | Укажите цену в коде из `GET /v1/fiat-currencies` (по умолчанию USD, EUR, UAH, GBP, CAD) или в криптовалюте |
| `401 auth.invalid_signature` | Подпись запроса не совпадает | Сверьте подпись с эталонным вектором в [аутентификации API](https://cryptolike.net/ru/docs/auth) |
| `403 auth.permission_denied` | У ключа нет нужного права (`details.required`) | Создайте ключ с `create_invoice` и `read` |
| `409 conflict`, `order_invoice_mismatch` | Заказ изменили после создания платежа | Отмените открытый платёж (`details.invoice_id`), пока он в статусе `new`, и создайте новый |
| `409 conflict`, `order_has_payment` | По заказу уже поступили средства | Не создавайте ещё один платёж; разберите заказ вручную |
| `422 no_allowed_coins` | Ни одна монета из `allowed_coin_ids` (или из списка в плагине) не доступна для инвойсов в этой валюте | Выберите другие монеты или включите «Для инвойсов» у одной из них в разделе «Монеты» |
| `429 rate_limited` | Слишком много запросов с ключа (по умолчанию 600 в минуту) | Подождите `Retry-After` секунд |
| `503 unavailable` | Курс или актив временно недоступны | Повторите с паузой или создайте платёж в криптовалюте |

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

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

Да. Ссылке на оплату CryptoLike не нужны ни сайт, ни код: создайте платёж в кабинете или командой `/invoice` в Telegram-боте и отправьте ссылку. Покупатель попадает на ту же страницу оплаты, что и в интернет-магазинах, а вы видите статус в кабинете или в сообщении Telegram.

### Какой способ запускается быстрее всего?

Ссылка на оплату — около 5 минут, коннектор Хорошоп — около 15, плагин CMS — 30–60 минут, интеграция через API — 1–3 дня, с тестовым платежом. Первый тестовый платёж через API занимает около 10 минут.

### Нужна ли своя нода или хранение ключей?

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

### Сколько стоит криптопроцессинг?

CryptoLike берёт комиссию платформы по каждому активу только когда платёж подтверждён и зачислен; за создание платежа комиссии нет. Действующие ставки для каждого актива — на [странице тарифов](https://cryptolike.net/ru/pricing).