Криптопроцессинг 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 минут | Заказ отмечается оплаченным; каждый шаг — в журнале синхронизации |
Загрузки и подробности по каждому способу — на странице интеграций, сценарии для магазинов — в разделе криптовалюта для интернет-магазина, для сервисов со своим бэкендом — криптоплатежи для цифровых товаров и SaaS, для пополнения балансов — пополнения на статические адреса. Пошаговый код для собственного бэкенда: на PHP, на Node.js и на Python.
Что подготовить
Для приёма криптовалюты через CryptoLike нужны аккаунт в кабинете, список активов, которые вы хотите принимать, и — для плагина или API — сайт на https. Верифицированный аккаунт (KYB) нужен только для выплат; платежи, ссылки на оплату, плагины и коннектор Хорошоп работают без него, так что начните верификацию заранее, если планируете выплаты. Тестируйте с тестовыми ключами (ck_test_) в тестовых сетях.
Доступные активы: Bitcoin, Litecoin, Ethereum с токенами USDT и USDC в ERC20, TRON с USDT в TRC20. Сеть и порог подтверждений каждого актива есть в GET /v1/currencies и на странице активов. В разделе кабинета «Монеты» переключатель «Включена» подключает актив к аккаунту, а «Для инвойсов» решает, предлагают ли его платежи.
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, OpenCart, PrestaShop или Magento 2 в админке магазина, вставьте ID ключа и секрет и нажмите «Проверить подключение». Добавьте URL вебхука из плагина как эндпоинт в разделе «Разработчикам» → «Вебхуки» со всеми событиями invoice.* и вставьте секрет эндпоинта обратно в плагин: плагин передаёт webhook_url с каждым платежом, и без включённого эндпоинта платёж не создастся. Двойной клик или перезагрузка вернут открытый платёж заказа, а не создадут второй.
API или SDK. Ваш сервер вызывает POST /v1/invoices и отправляет покупателя на checkout_url — или оставляет его на вашей странице с виджетом оплаты. SDK для TypeScript, Python, Go и PHP подписывают запросы и добавляют Idempotency-Key; пока это пре-релиз, они ставятся из репозитория.
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. Подробнее — ссылки на оплату.
Коннектор Хорошоп. Хорошоп не принимает сторонние платёжные плагины, поэтому CryptoLike подключается к магазину через его API: создайте в Хорошоп отдельного администратора, добавьте способ оплаты «Криптовалюта» простого типа, затем в кабинете откройте «Интеграции» → Хорошоп и нажмите «Проверить». Ссылка на оплату приходит покупателю на e-mail примерно через минуту после заказа.
4. Получайте результат подписанным вебхуком
CryptoLike сообщает результат вебхуком с подписью HMAC-SHA256: событие invoice.paid означает, что средства подтверждены и зачислены на ваш баланс. Эндпоинт отвечает 2xx за 10 секунд; неудачная доставка повторяется через 1 мин, 5 мин, 15 мин, 1 ч, 6 ч и 24 ч с тем же event_id, поэтому обрабатывайте каждое событие один раз.
Плагины и коннектор Хорошоп применяют события сами. При работе через API проверяйте подпись вебхука по сырому телу запроса — см. проверку подписи вебхуков — и отгружайте по paid; остальные состояния описаны в модели статусов. Обработчик отклоняет настоящие доставки? Скорее всего, в нём неверный секрет эндпоинта. Секрет показывается только один раз, поэтому выпустите новый в «Разработчикам» → «Вебхуки» и разверните его.
5. Проведите тестовый платёж и запускайтесь
Тестовые платежи CryptoLike идут в тестовых сетях: тестовые монеты ничего не стоят, и их может прислать поддержка CryptoLike; отправьте точную сумму на адрес со страницы оплаты и проследите, как статус меняется с pending на paid. Магазину на CMS пригодится полный чек-лист запуска для интернет-магазина. Затем переключите плагин или сервер на боевой ключ и уберите тестовые ключи и тестовый адрес API из продакшен-конфигурации. Полная репетиция по всем статусам — в инструкции как протестировать криптоплатежи.
Один раз недоплатите намеренно больше чем на 0,5 %, чтобы увидеть underpaid, и дайте одному платежу истечь, чтобы увидеть expired. У Хорошоп нет песочницы: закажите дешёвый скрытый тестовый товар и оплатите небольшую сумму.
Ошибки и что делать
CryptoLike возвращает любую ошибку API в одном формате: HTTP-статус, машиночитаемый code, message для человека и details с указанием проблемы. Ветвитесь по code и исправляйте то, на что указывает details.field или details.reason. Здесь — ошибки, которые чаще всего встречаются в новой интеграции; полный список — в справочнике API.
| HTTP · code | Что произошло | Что делать |
|---|---|---|
400 validation_error, поле currency |
Валюта заказа не включена для вашего аккаунта | Укажите цену в коде из GET /v1/fiat-currencies (по умолчанию USD, EUR, UAH, GBP, CAD) или в криптовалюте |
401 auth.invalid_signature |
Подпись запроса не совпадает | Сверьте подпись с эталонным вектором в аутентификации API |
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 берёт комиссию платформы по каждому активу только когда платёж подтверждён и зачислен; за создание платежа комиссии нет. Действующие ставки для каждого актива — на странице тарифов.