Вопросы и ответы о криптопроцессинге CryptoLike

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

#Начало работы

#Что такое CryptoLike?

CryptoLike — платформа криптопроцессинга. Бизнес принимает Bitcoin, Litecoin, Ethereum, TRON и стейблкоины USDT/USDC через REST API, плагины для CMS, ссылки на оплату и страницу оплаты, получает результат подписанным вебхуком и делает выплаты с одного баланса. Весь путь платежа показан на странице о том, как CryptoLike принимает криптовалюту.

#Могут ли пользоваться CryptoLike частные лица или только бизнес?

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

#Сколько занимает интеграция CryptoLike?

Первый платёж в тестовой сети — примерно десять минут: создать API-ключ, вызвать POST /v1/invoices со своего сервера, отправить клиента на checkout_url и обработать один подписанный вебхук. В проде это тот же код из трёх частей, а остальная работа приходится на ваши статусы заказа. Каждый шаг разобран в руководстве разработчика CryptoLike.

#Нужно ли поднимать ноду и хранить приватные ключи?

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

#Есть ли тестовый режим?

Да. Ключи CryptoLike с префиксом ck_test_ подписывают запросы так же, как боевые, и работают с тестовыми сетями через тестовый адрес API; тестовые монеты ничего не стоят, адрес и монеты даст поддержка CryptoLike. В основных сетях тестовый ключ отклоняется с 401 auth.test_key. Держите тестовые и рабочие ключи в разных конфигурациях. Эталонный вектор подписи за один вызов покажет, верно ли вы подписываете. См. тестовые ключи и тестовые сети.

#Какой способ приёма криптовалюты выбрать?

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

#Платежи и статусы

#Какие статусы бывают у платежа в CryptoLike?

Платёж проходит путь new → pending → paid. pending — перевод обнаружен и ждёт подтверждений; paid — вся сумма подтверждена и зачислена. underpaid остаётся открытым для доплаты до конца срока платежа, затем становится окончательным. expired (срок вышел, ничего не подтверждено) и cancelled (вы отменили платёж из new) — конечные. Эти же строки видны в кабинете, API и вебхуках: модель статусов платежа.

#Как узнать, что платёж подтверждён?

Подпишите вебхук: каждое событие CryptoLike подписано HMAC-SHA256 и повторяется с тем же event id, поэтому обработчик может выполнить действие один раз и игнорировать повторы. Или читайте GET /v1/invoices/{id} со своего сервера не чаще раза в несколько секунд: статус paid означает, что средства подтверждены и зачислены на ваш баланс. Все события описаны в контракте вебхуков.

#Как работает платёж с суммой в фиате?

Создайте платёж в USD, EUR или другой включённой фиатной валюте; поле currency принимает и тикер монеты. Курс фиксируется в момент, когда известна монета, — при создании или когда плательщик выбирает монету на странице оплаты, — и держится до истечения платежа. Спреда конвертации нет: сумма в крипте — это цена по зафиксированному курсу с округлением вверх до наименьшей единицы монеты. Подробнее — фиксация курса.

#В каких фиатных валютах можно указать цену?

Цену можно указать в USD, EUR, UAH, GBP или CAD либо в монете; все пять включены для каждого аккаунта по умолчанию. Плательщик платит криптовалютой по курсу, зафиксированному при выборе актива. Если два источника курса расходятся по паре больше допустимого предела, платёж отвечает 503 unavailable, пока они не сойдутся: угаданный курс не используется. Другую валюту добавляем, только когда её котируют два независимых источника. Подробнее — цена в фиате.

#Можно ли ограничить монеты, из которых выбирает плательщик?

Да, в двух местах. В разделе кабинета «Монеты» переключатель «Для инвойсов» решает, какие монеты предлагают ваши платежи; статические адреса и выплаты от него не зависят. Для одного платежа передайте allowed_coin_ids в API, сократите список монет в форме инвойса или отметьте монеты в настройках плагина. Если ни одну из них нельзя предложить в этой валюте, API ответит 422 no_allowed_coins. Подробнее — в руководстве по инвойсам.

#Что, если клиент заплатил меньше или больше?

Меньше: платёж переходит в underpaid, страница показывает остаток, и клиент может доплатить на тот же адрес до истечения срока; недостача в пределах допуска вашего аккаунта всё равно считается оплатой paid. Больше: платёж считается оплаченным, вся сумма зачисляется вам, а вебхук содержит overpaid_amount — рассчитаться с клиентом вы можете сами. Читайте, как CryptoLike обрабатывает недоплату.

#Что, если клиент заплатил после истечения срока?

Средства всё равно зачисляются на ваш баланс. Статус платежа не меняется, у него появляется late_payment: true, а CryptoLike отправляет invoice.late_payment. Решите с клиентом, выполнить заказ или вернуть средства; плагины CMS переводят такой заказ на проверку и никогда не отмечают его оплаченным автоматически. Для клиента порядок простой: срок платежа истёк — создайте новый платёж. См. просроченный платёж.

#Инвойс или статический адрес — что мне нужно?

Инвойс — разовый платёж на фиксированную сумму с ограничением по времени: заказ, пополнение, списание за подписку. Статический адрес — постоянный адрес для одного клиента, на котором каждый входящий перевод зачисляется после подтверждений этого актива: балансы, депозиты, регулярные пополнения. В CryptoLike и то и другое создаётся одним вызовом API и сообщает о себе через одни и те же вебхуки. Подробнее — статический адрес.

#Что будет, если подтверждённый перевод откатится?

Если реорганизация сети отменила подтверждённый перевод, CryptoLike пересчитывает платёж и отправляет invoice.reverted: paid_amount уменьшается, статус следует за ним. Остановите выдачу товара, пока не придёт новый invoice.paid. Для статических адресов в том же случае приходит deposit.reverted. Плагины CMS переводят откатившийся оплаченный заказ на проверку, чтобы его не отгрузили. Правило входит в модель статусов платежа.

#Активы и сети

#Какие активы можно принимать?

CryptoLike принимает Bitcoin (BTC), Litecoin (LTC), Ethereum (ETH) с токенами ERC20 USDT и USDC, а также TRON (TRX) с USDT в сети TRC20. Актуальный каталог отдаёт GET /v1/currencies; у каждого актива видны сеть и порог подтверждений до того, как вы его используете, а отдельные активы можно выключить в кабинете — целиком или только для инвойсов. Список с сетями — на странице поддерживаемых монет.

#Сколько времени занимает подтверждение платежа?

Зависит от актива: у каждого свой порог подтверждений, заданный в каталоге CryptoLike (GET /v1/currencies) и показанный на странице оплаты как «n из N подтверждений, обычно около X мин». Плательщик видит «Платёж обнаружен», как только перевод появился в сети, и «Платёж подтверждён», когда порог достигнут, — в этот момент средства зачисляются на ваш баланс. Подробнее — подтверждения криптоплатежей.

#USDT в TRC20 или ERC20 — что принимать?

В CryptoLike это два разных актива: USDT в сети TRON (TRC20) и USDT в сети Ethereum (ERC20), у каждого свой адрес, порог подтверждений и тариф. Сетевую стоимость перевода оплачивает плательщик: в TRON это энергия и bandwidth, оплачиваемые в TRX, в Ethereum — газ в ETH. Адреса TRON начинаются с «T», адреса Ethereum — с «0x». Можно включить оба актива и дать клиенту выбрать на странице оплаты. Читайте USDT TRC20 или ERC20.

#Что, если клиент отправил средства не в той сети?

Перевод в другой сети не доходит до платежа, и платёж остаётся неоплаченным. Страница оплаты CryptoLike называет сеть рядом с активом и адресом, добавляет значок сети к иконкам токенов и предупреждает о сети до отправки. Тестовые адреса Bitcoin и Litecoin отличаются от основных, а у TRON и Ethereum формат в обеих сетях один, поэтому название сети важно проверять и при тестах. Какую сеть использует каждый актив, видно в списке активов и сетей.

#Комиссии

#Сколько стоит CryptoLike?

Стандартная ставка — 0,8 % от каждого подтверждённого входящего платежа, но не меньше минимума актива: 0,6 USDT в TRON (около $0,6 в BTC, LTC или TRX), 2 USDT или USDC в Ethereum (около $2 в ETH). Комиссии платформы на выплаты нет, кроме фиксированного 1 USDT для USDT в TRON; сетевую комиссию вы платите без наценки. Цена в USD или EUR пересчитывается без спреда. Для больших оборотов ставки согласуются индивидуально. Все минимумы — на странице тарифов.

#Зачем нужен минимум комиссии?

Потому что сбор платежа стоит примерно одинаково при любой сумме. Каждый входящий платёж затем переводится с платёжного адреса в кошелёк платформы транзакцией в сети, комиссию за которую платит платформа; в Ethereum она выше, чем в TRON, Bitcoin или Litecoin. Минимум действует до 75 USDT в TRON и до 250 USDT в Ethereum, выше — только 0,8 %. Перевод меньше минимума целиком уходит в комиссию. Точные минимумы — в таблице тарифов.

#Как показываются комиссии?

Конкретной суммой с единицей измерения: в расчёте выплаты до подтверждения, в ответе API и в кабинете. Плательщик на странице оплаты видит одну сумму; если комиссию несёт он, она уже в неё включена. Комиссия платформы CryptoLike задаётся по каждому активу и списывается только при подтверждении платежа; каждая транзакция затем показывает сумму брутто, комиссию и сумму нетто. Действующие тарифы — на странице тарифов CryptoLike.

#Когда списывается комиссия платформы?

Только при подтверждении платежа и по ставке, действовавшей при его создании: смена тарифа не пересчитывает уже созданный платёж. Создание платежа ничего не стоит, а за просроченный или отменённый платёж комиссия не списывается. Комиссия платформы CryptoLike задаётся по каждому активу и направлению — входящие платежи и выплаты. В каждой строке транзакций видны amount (брутто), fee и net_amount. Действующие ставки — на странице тарифов.

#Кто платит комиссию платформы — продавец или клиент?

По умолчанию продавец: fee_paid_by равно merchant, и комиссия удерживается из суммы, которую вы получаете. С fee_paid_by: payer в платеже CryptoLike добавляет комиссию сверху: payer_amount — сколько должен отправить клиент, amount_crypto — сколько получаете вы. Эти суммы различаются только в этом случае. Подробнее — комиссия платформы.

#Как считается комиссия сети при выплате?

Перед выплатой POST /v1/withdrawals/estimate возвращает комиссию платформы, зарезервированную комиссию сети и общую сумму списания; резерв — это оценка сети без наценки. CryptoLike списывает либо зарезервированную оценку (по умолчанию), либо фактически уплаченную в сети комиссию (network_fee_mode: actual) — тогда неиспользованный резерв возвращается на доступный баланс. Если оценка недоступна, выплата не создаётся. Подробнее — комиссия сети.

#Выплаты

#Как сделать выплату?

Запросите POST /v1/withdrawals/estimate, чтобы увидеть комиссии и сумму списания, затем создайте выплату через POST /v1/withdrawals или в кабинете. CryptoLike переводит всю сумму списания в hold, а выплата проходит статусы pending → processing → broadcast → completed. API-ключу нужно право withdraw; в кабинете каждая выплата подтверждается кодом 2FA. Статусы и ошибки — в справочнике API.

#Как работают массовые выплаты?

Загрузите в кабинет CryptoLike CSV до 1 000 строк в формате address,amount[,payout_id[,comment]]. Каждая строка проверяется до того, как что-либо создаётся: одна ошибочная строка отклоняет весь файл с отчётом «строка, поле, ошибка», и ничего не выплачивается. Корректный файл подтверждается одним кодом 2FA на весь пакет. Через API выплаты создаются по одной с payout_id. Пошагово — в гайде по массовым выплатам.

#Может ли повторный запрос выплатить дважды?

Нет, если вы передаёте свой payout_id. Повтор запроса с той же монетой, суммой и адресом возвращает уже созданную выплату CryptoLike, а не создаёт новую; тот же payout_id с другими параметрами отклоняется с 409. Чтобы получить в точности первый ответ, добавьте Idempotency-Key. Правила описаны в справочнике API.

#Почему выплата на проверке?

Выплата попадает в review, когда нужна ручная проверка: превышен лимит, нетипичный сценарий (новый адрес, всплеск выплат), аккаунт в ручном режиме или адрес назначения требует комплаенс-проверки. Обычно проверка завершается в течение 24 часов, всё это время средства остаются в hold. Затем CryptoLike продолжает выплату или отклоняет её и возвращает всю сумму на доступный баланс. См. массовые выплаты.

#Что будет, если выплата не прошла или отменена?

Выплата не прошла: сеть отвергла или сбросила транзакцию, и вся сумма списания вернулась на доступный баланс; причина — в failure_reason. Создайте новую выплату. Выплата, отклонённая на проверке, возвращается так же. Отменить выплату CryptoLike можно самому, пока она в pending, review или awaiting_approval; из processing отмена уже невозможна. Статусы — в справочнике API.

#Нужна ли верификация аккаунта для выплат?

Да. CryptoLike отправляет выплаты только с верифицированного аккаунта: пока верификация аккаунта (KYB) не завершена, запрос выплаты получает 403 kyb_required. Загрузите документы в кабинете и дождитесь проверки; шаги описаны в статье KYB для мерчантов. Приём платежей, включая ссылки на оплату и подключение Хорошоп, верификации не ждёт. Всё, что нужно для выплат, перечислено в сценарии массовых выплат.

#Интеграции

#Для каких платформ есть плагин CryptoLike?

У CryptoLike есть плагин для WooCommerce (блочная и классическая корзина), расширение для OpenCart 3 и 4, модуль для PrestaShop 1.7.8 и 8 и модуль для Magento 2. Магазины на Хорошоп подключаются через коннектор на нашей стороне, без плагина. Любому плагину нужен API-ключ только с правами create_invoice и read; право withdraw магазину не нужно. Все варианты — на странице интеграций.

#Как плагин CryptoLike обновляет статус заказа?

Заказ создаётся в статусе ожидания оплаты. Подтверждённый платёж переводит его в обработку (или выбранный вами статус); при недоплате заказ ставится на удержание, пока клиент может доплатить; просроченный платёж отменяет заказ или оставляет его в ожидании — как вы настроили. Деньги, которым нужен человек, например поздняя оплата или откат, переводят заказ на проверку и никогда не отмечаются оплатой автоматически. См. плагин для WooCommerce.

#Как принимать криптовалюту в магазине на Хорошоп?

Хорошоп не принимает сторонние платёжные плагины, поэтому CryptoLike подключается к магазину через его API. Создайте отдельного администратора для CryptoLike, добавьте способ оплаты «Криптовалюта» и подключите магазин в кабинете: «Интеграции → Хорошоп». Примерно через минуту после заказа клиент получает письмо со ссылкой на оплату, а статус оплаты записывается обратно в заказ. Подробно — интеграция с Хорошоп.

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

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

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

Да. Виджет CryptoLike встраивает ту же страницу оплаты в iframe загрузчиком примерно на 5 КБ и сообщает вашей странице об изменениях статуса через postMessage. Добавьте свой origin в список разрешённых в кабинете; браузер получает id счёта и больше ничего. Выполняйте заказ по вебхуку, а не по сообщению из браузера. Подробности — в руководстве по виджету оплаты.

#Разработчикам

#Как обработать вебхук ровно один раз?

Проверьте подпись HMAC-SHA256 по сырому телу, затем поищите event_id в своём хранилище: если он уже был, ответьте 2xx и остановитесь. CryptoLike доставляет не менее одного раза и повторяет доставку шесть раз примерно за 31 час, так что дубликаты — норма, а не сбой. Отвечайте в течение 10 секунд, а обрабатывайте после. Пошагово — проверка вебхуков криптоплатежей.

#Как проверить подпись вебхука CryptoLike?

Вычислите "sha256=" + hex(HMAC-SHA256(secret, X-Timestamp + "." + raw_body)) секретом своего эндпоинта и сравните с X-Signature за постоянное время. Берите сырые байты в том виде, как они пришли, а не пересобранный JSON, и отклоняйте метки времени, которые расходятся с вашими часами больше чем на несколько минут в любую сторону; в SDK допуск 300 секунд. Эталонный тестовый вектор проверит ваш код за один запуск. См. контракт вебхуков.

#Какие SDK есть у CryptoLike?

Четыре серверных SDK: TypeScript для Node.js 18+, Python 3.10+, Go 1.23+ и PHP 7.4–8.x. Каждый подписывает запросы, добавляет Idempotency-Key к каждому POST, аккуратно повторяет запросы и проверяет вебхуки. Это предрелизные версии: они ставятся из репозитория CryptoLike, в npm, PyPI и Packagist их пока нет. Секрет остаётся на вашем сервере. См. документацию SDK.

#Как повторы запросов не создают второй платёж?

Передавайте Idempotency-Key с каждым POST: повторный запрос в течение 24 часов возвращает исходный ответ CryptoLike, а другое тело с тем же ключом отклоняется с 422. Магазины могут также передать idempotency_by_order_id: true вместе с order_id: повтор для того же заказа вернёт его открытый платёж, а не создаст второй. Подробнее — ключ идемпотентности.

#Аккаунт и контроль доступа

#Что может API-ключ CryptoLike?

У каждого ключа есть права: read, create_invoice, create_address и withdraw, а также лимит запросов (по умолчанию 600 запросов в минуту, его можно изменить для ключа) и, по желанию, белый список IP. Запрос без нужного права или с чужого IP получает 403, сверх лимита — 429. Давайте ключу только нужное: плагину магазина хватает create_invoice и read. Секрет показывается один раз. См. аутентификацию API.

#Как сменить или отозвать API-ключ?

В кабинете CryptoLike ротация выпускает новый секрет и показывает его один раз; прежний секрет работает ещё 10 минут, чтобы вы обновили конфигурацию без простоя. Отключение останавливает ключ, пока вы его снова не включите. Отзыв окончателен: ключ перестаёт работать сразу, нужен новый. Каждое изменение записывается в журнал безопасности команды с именем того, кто его сделал. См. аутентификацию API.

#Как работает белый список адресов для выплат?

Адрес для выплат добавляется в кабинете CryptoLike со свежим кодом 2FA и становится активным только после задержки, поэтому украденная сессия не сможет сразу перенаправить выплаты. Удаление адреса действует сразу. Когда белый список включён, выплаты из кабинета и через API-ключи уходят только на активные адреса из списка, остальные получают 403. Подробнее — белый список адресов выплат.

#Как работает второе подтверждение крупных выплат?

Если выплата, созданная в кабинете, превышает порог вашего аккаунта, она ждёт в статусе awaiting_approval. Её подтверждает в кабинете CryptoLike другой владелец или администратор аккаунта — не тот, кто её создал, — кодом 2FA; до этого средства остаются в hold. Выплаты через API-ключ с правом withdraw второго подтверждения не ждут, поэтому выдавайте это право осознанно. См. двойное подтверждение.

#Когда CryptoLike запрашивает код 2FA?

Для действий, которые двигают деньги или открывают новый адрес получателя. Кабинет CryptoLike запрашивает свежий код 2FA, когда вы создаёте выплату, подтверждаете CSV-пакет (один код на весь файл), даёте второе подтверждение, добавляете адрес в белый список, меняете настройки выплат или даёте API-ключу право withdraw; Telegram-бот — на выплатах. Удаление адреса из белого списка кода не требует. API-выплаты вместо кода проверяют право ключа. См. гайд по массовым выплатам.

#Как CryptoLike защищает средства на балансе?

Приватные ключи остаются в отдельном сервисе подписи, к которому у API нет доступа, и он подписывает выплату, только если она в обработке и в журнале проводок есть соответствующая блокировка суммы. Излишки уходят в холодное хранение лишь после подтверждения оператора с 2FA. Выплаты из кабинета требуют свежий код 2FA, выплаты через API — ключ с правом withdraw, а белый список и второе подтверждение вы включаете сами. Все механизмы — на странице безопасности.