Приём криптовалюты в магазине на Хорошоп

CryptoLike подключается к магазину на Хорошоп через API платформы, без плагина: на каждый заказ со способом оплаты «Криптовалюта» создаёт платёж, отправляет покупателю ссылку на оплату по e-mail и сам отмечает заказ оплаченным, когда платёж подтверждён. Настройка занимает около 15 минут в кабинете CryptoLike и не требует разработчика.

#Как это работает

Покупатель оформляет заказ как обычно, а оплату криптовалютой ведёт CryptoLike: от письма со ссылкой до статуса заказа в админке Хорошоп. Магазин проверяется раз в минуту, поэтому ссылка приходит в течение пары минут после заказа.

1. Покупатель оформляет заказ и выбирает созданный вами способ оплаты, например «Криптовалюта». Хорошоп показывает обычную страницу «Спасибо».
2. Примерно в течение минуты CryptoLike забирает новый заказ и создаёт платёж на сумму заказа в его валюте.
3. Покупатель получает письмо от CryptoLike с названием магазина, номером заказа, суммой и ссылкой на страницу оплаты. Там он выбирает монету и сеть, видит сумму и оставшееся время и платит.
4. Когда платёж подтверждён, CryptoLike отмечает заказ оплаченным в Хорошоп и ставит выбранный вами статус (по умолчанию «В обробці»).
5. Если время оплаты истекло или вы отменили платёж, заказ получает статус для этого случая (по умолчанию «Не доставлено») или остаётся как есть — как вы настроите.

API Хорошоп не позволяет добавить собственный платёжный шлюз, изменить письма магазина или написать покупателю, поэтому ссылка приходит отдельным письмом от CryptoLike. Предупредите об этом в описании способа оплаты (шаг 2).

#Что нужно

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

#1. Создайте API-администратора в Хорошоп

В админке магазина откройте «Налаштування → Адміни» и добавьте администратора только для CryptoLike, например cryptolike-api, с длинным уникальным паролем. Отдельных API-ключей в Хорошоп нет: коннектор входит под логином и паролем этого администратора, поэтому не используйте учётную запись сотрудника.

#2. Создайте способ оплаты

В настройках оплаты магазина добавьте простой способ без встроенного шлюза, например «Криптовалюта (BTC, USDT и другие)». В описании напишите: «Ссылка на оплату придёт на e-mail в течение нескольких минут». Так покупатель будет ждать письмо, а не искать кнопку оплаты на сайте.

#3. Подключите магазин в CryptoLike

Кабинет → Интеграции → Хорошоп → Подключить. Введите домен магазина (shop.example.ua), логин и пароль API-администратора и нажмите Проверить. CryptoLike войдёт в магазин и загрузит ваши способы оплаты и статусы заказов. Логин и пароль при сохранении шифруются и больше не показываются.

#4. Выберите, что делает коннектор

Способ оплаты — тот, что создан на шаге 2: CryptoLike берёт только заказы с ним. Статус после оплаты — по умолчанию «В обробці». Статус для истёкшего или отменённого платежа — по умолчанию «Не доставлено», либо заказ остаётся ждать оплату. «Добавлять доставку к сумме» по умолчанию выключено, потому что сумма заказа в Хорошоп без доставки; включите, если покупатель платит за доставку вместе с товаром. Ещё — название магазина и язык письма: украинский, русский или английский.

#5. Сохраните и проверьте тестовым заказом

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

#Статусы заказа

Оплаченный заказ никогда не понижается: запоздавшее «время истекло» его не трогает.

Эти правила одинаковы на всех платформах; остальные платформы для магазинов сравниваются в разделе криптовалюта для интернет-магазина.

#Журнал синхронизации и частые проблемы

Кабинет → Интеграции → Хорошоп → Журнал синхронизации показывает, что произошло с каждым заказом: взят, платёж создан, ссылка отправлена, статус записан, повторы и ошибки. Записи хранятся 90 дней.

Чтобы временно остановить коннектор, нажмите Пауза. Отключить останавливает синхронизацию и удаляет сохранённые логин, пароль и журнал; уже созданные платежи остаются в аккаунте.

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

#Нужен ли плагин или разработчик, чтобы принимать криптовалюту на Хорошоп?

Нет. CryptoLike подключается к магазину через API Хорошоп под отдельным администратором, а всё остальное настраивается в кабинете CryptoLike примерно за 15 минут. Нужны тариф Хорошоп с доступом к API, способ оплаты «Криптовалюта» и аккаунт CryptoLike; верификация аккаунта (KYB) нужна только для выплат.

#Почему ссылка на оплату приходит письмом, а не на странице магазина?

API Хорошоп не даёт подключить собственный платёжный шлюз, изменить письма магазина или показать сообщение покупателю. Поэтому CryptoLike отправляет ссылку отдельным письмом с названием магазина, номером заказа и суммой. Напишите в описании способа оплаты, что ссылка придёт на e-mail в течение нескольких минут.

#Можно ли принимать оплату в гривнах?

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

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

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

#Как проверить подключение, если у Хорошоп нет тестового режима?

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

#Какими монетами можно платить?

Покупатель выбирает на странице оплаты одну из монет, доступных для инвойсов (раздел «Монеты» → «Для инвойсов» в кабинете), и у каждой видит ориентировочную сумму: Bitcoin, Litecoin, Ethereum, TRON, USDT в сетях TRON и Ethereum или USDC. Список с порогами подтверждений — на странице поддерживаемых монет; для покупателей из Украины чаще всего удобен USDT в сети TRON.