Интеграции
Принимайте крипту так, как вы уже продаёте.
Выберите, как продаёт ваш бизнес сейчас. Каждый путь заканчивается одинаково: подтверждённый платёж и статус заказа, с которым команда может работать.
Путь 1 из 5
Плагин для CMS вашего магазина
В checkout появляется «Оплатить криптовалютой»; плагин создаёт платёж, ведёт на него покупателя и переводит заказ, когда оплата подтверждена.
Для кого
Интернет-магазины на WooCommerce (WordPress), OpenCart 3.0 или 4.0, PrestaShop 1.7.8 или 8, Magento 2.4.6+. Ставится как любой платёжный плагин.
Что нужно
- Доступ администратора к магазину, магазин работает по https.
- API-ключ с двумя правами: create_invoice и read.
- Вебхук-эндпоинт в кабинете на URL плагина и его секрет.
Шаги
- Скачайте архив для своей CMS ниже и загрузите его в админке магазина.
- В кабинете создайте API-ключ в тестовом режиме с правами create_invoice и read.
- Вставьте ID ключа и секрет в настройки плагина и нажмите «Проверить подключение».
- Скопируйте URL вебхука из плагина, добавьте его как эндпоинт в кабинете со всеми событиями invoice и вставьте секрет эндпоинта обратно в плагин.
- Оформите тестовый заказ и оплатите его в тестовой сети. Затем переключите плагин на боевой ключ.
Что получит покупатель
В checkout покупатель выбирает «Оплатить криптовалютой» и попадает на страницу оплаты: актив и сеть, сумма, комиссия сети, адрес с QR-кодом и оставшееся время. После оплаты он возвращается на страницу заказа.
Статусы и вебхуки
Оплачен → заказ получает выбранный вами статус (по умолчанию «В обработке»). Платёж обнаружен → заказ ждёт. Истёк → отмена или ожидание, как настроите. Поздние и частичные оплаты ждут вашего решения. Каждый вебхук проверяется по подписи и применяется один раз.
Инструкции и загрузки
Путь 2 из 5
Магазин на Хорошоп
Хорошоп не принимает сторонние платёжные плагины, поэтому CryptoLike подключается к магазину со своей стороны через его API.
Для кого
Магазины на платформе Хорошоп, которые продают в гривне и хотят добавить криптовалюту как ещё один способ оплаты — без разработчика.
Что нужно
- Тариф Хорошоп с доступом к API и отдельный администратор для CryptoLike.
- Способ оплаты «Криптовалюта» простого типа в вашем магазине.
- Валюта магазина (обычно UAH), включённая для вашего аккаунта, — её включает поддержка.
Шаги
- В Хорошоп создайте администратора только для CryptoLike.
- Добавьте способ оплаты «Криптовалюта» и укажите в описании, что ссылка на оплату придёт на e-mail.
- В кабинете откройте Интеграции → Хорошоп, введите домен магазина, логин и пароль, нажмите «Проверить».
- Выберите способ оплаты и статусы заказа для оплаченного и истёкшего платежа. Сохраните.
- Оформите тестовый заказ и следите за ним в журнале синхронизации.
Что получит покупатель
Примерно через минуту после заказа покупатель получает письмо от CryptoLike с названием вашего магазина, номером заказа, суммой и ссылкой на страницу оплаты.
Статусы и вебхуки
Оплачен → заказ отмечается оплаченным и получает ваш статус (по умолчанию «В обробці»). Истёк или отменён → ваш статус (по умолчанию «Не доставлено») или без изменений. Каждый шаг виден в журнале синхронизации в кабинете. Настраивать вебхуки не нужно.
Инструкции и загрузки
Путь 3 из 5
Свой сайт или приложение: API и SDK
От вызова API до статуса платежа: один POST создаёт платёж, страница оплаты принимает его, подписанный вебхук сообщает вашему серверу.
Для кого
Команды со своим бэкендом — маркетплейсы, SaaS, игры, сервисы со своим checkout или мобильное приложение с сервером.
Что нужно
- Сервер, который хранит секрет, — никогда не браузер и не мобильное приложение.
- API-ключ: create_invoice и read (плюс create_address для постоянных адресов пополнения).
- Эндпоинт https для вебхуков.
Шаги
- Создайте тестовый API-ключ в кабинете.
- Установите SDK для своего языка или подписывайте запросы сами (HMAC-SHA256).
- Создайте платёж: POST /v1/invoices с amount, currency и вашим order_id.
- Отправьте покупателя на checkout_url или встройте страницу виджетом.
- Обрабатывайте вебхуки invoice.*: проверьте подпись, пропускайте повторы по event_id, отвечайте 2xx.
- Пройдите чек-лист запуска и переключитесь на боевой ключ.
Что получит покупатель
Страница оплаты с вашим названием и логотипом: актив и сеть, сумма, комиссия сети, адрес с QR-кодом, оставшееся время и статус, который обновляется сам.
Статусы и вебхуки
new → pending → paid. У underpaid, expired и cancelled есть понятный следующий шаг для покупателя. Вебхуки подписаны, повторяются с нарастающей паузой и несут event_id для дедупликации.
Инструкции и загрузки
HTTP API
TypeScript / Node.js
npm install @cryptolike/sdkПре-релиз: пока пакет не опубликован, установка из репозитория — см. инструкцию.
Python
pip install cryptolikeПре-релиз: пока пакет не опубликован, установка из репозитория — см. инструкцию.
Go
go get github.com/Petya88/Cryptolike/sdk/goПре-релиз: пока пакет не опубликован, установка из репозитория — см. инструкцию.
PHP
composer require cryptolike/sdkПре-релиз: пока пакет не опубликован, установка из репозитория — см. инструкцию.
Путь 4 из 5
Ссылка на оплату без кода
Создайте платёж в кабинете или в Telegram, отправьте ссылку и увидьте, когда он оплачен.
Для кого
Фрилансеры, счета для B2B, продажи в мессенджерах и соцсетях — когда интегрировать checkout некуда.
Что нужно
- Аккаунт CryptoLike с верифицированным бизнесом.
- По желанию: Telegram-бот CryptoLike, привязанный к аккаунту.
Шаги
- В кабинете откройте Инвойсы → Создать платёж: сумма, валюта и описание, которое увидит покупатель.
- Поделитесь ссылкой — скопируйте её или отправьте сразу в мессенджер. В боте то же делает команда /invoice.
- Следите за статусом в кабинете или получите сообщение в Telegram, когда оплата подтверждена.
Что получит покупатель
Та же страница оплаты, что и у интернет-магазинов: сумма, сеть, комиссия сети, адрес, оставшееся время и живой статус.
Статусы и вебхуки
Все статусы видны в кабинете и в уведомлениях. Вебхуки здесь не обязательны — добавьте эндпоинт, только если результат нужен другой системе.
Инструкции и загрузки
Кабинет
Telegram-бот
Путь 5 из 5
Оплата внутри вашей страницы: виджет
Покупатель остаётся в вашем checkout: страница оплаты открывается во фрейме в вашей вёрстке, в вашей теме и на вашем языке.
Для кого
Сайты со своим checkout, которые не хотят уводить покупателя на другую страницу.
Что нужно
- Сервер, который создаёт платёж (API, SDK или плагин), — виджет только показывает его.
- Origin вашего сайта в списке разрешённых: кабинет → Настройки → Профиль и безопасность → Интеграция.
- Content-Security-Policy вашей страницы, разрешающая скрипт и фрейм.
Шаги
- Добавьте origin своего сайта в список разрешённых в кабинете.
- Создайте платёж на сервере и передайте на страницу только id инвойса.
- Подключите /widget/v1/cryptolike.js и вызовите CryptoLike.mount(element, { invoiceId }).
- События paid и expired используйте для интерфейса; заказ подтверждайте по вебхуку.
Что получит покупатель
Страница оплаты внутри вашего checkout. Меняет высоту по содержимому, берёт ваш акцентный цвет и язык.
Статусы и вебхуки
События на странице — только для интерфейса. Заказ подтверждает подписанный вебхук или GET /v1/invoices/{id} с вашего сервера.
Инструкции и загрузки
Виджет оплаты
Сравните способы
Время запуска — при верифицированном аккаунте и с тестовым платежом перед запуском.
| Способ | Время до запуска | Нужен разработчик? | Настройка | Где проходит оплата |
|---|---|---|---|---|
| Плагин CMS | 30–60 минут | Нет | Статусы заказа, поведение при истечении, тексты checkout | Страница оплаты CryptoLike |
| Коннектор Хорошоп | Около 15 минут | Нет | Статусы заказа, язык письма, название магазина | Страница оплаты CryptoLike, ссылка на e-mail |
| API или SDK | 1–3 дня | Да, бэкенд | Полная: ваш процесс и данные вокруг платежа | Страница оплаты CryptoLike или встроенная |
| Ссылка на оплату | 5 минут | Нет | Сумма, валюта, описание | Страница оплаты CryptoLike |
| Виджет | Несколько часов поверх API | Да, фронтенд | Место на странице, тема, акцентный цвет, язык | Внутри вашей страницы |
Перед запуском
Эти четыре вещи одинаковы для всех путей, кроме ссылки на оплату.
API-ключ
Разработчикам → API-ключи. Ключи ck_test_ работают только в тестовых сетях, ck_live_ двигают реальные средства. Давайте ключу только нужные права: магазину никогда не нужен withdraw.
Секрет вебхука
У каждого эндпоинта свой секрет, он показывается один раз. Проверяйте X-Signature по сырому телу и отклоняйте события старше 5 минут.
Тестовый режим
Ключ ck_test_ проходит тот же путь в публичных тестовых сетях — тестовые монеты ничего не стоят. Оплатите один заказ, недоплатите второй, дайте третьему истечь.
Чек-лист запуска
- Боевой ключ лежит в окружении сервера, а не в коде и не в браузере.
- Вебхук-эндпоинт на https и подписан на все события invoice.*.
- Подпись проверяется, повторные события пропускаются по event_id.
- Заказ меняет статус только по вебхуку или API — никогда по странице возврата.
- Один оплаченный и один истёкший тестовый платёж прошли от начала до конца.
- Кто-то в команде получает уведомления о платежах, которым нужно решение.
Начните с тестового ключа.
Создайте аккаунт, возьмите ключ ck_test_ и проведите первый платёж в тестовой сети уже сегодня.