К содержанию

Приём криптовалюты в Magento

Модуль CoinsPay добавит в оформление заказа Magento способ «Криптовалюта». Покупатель платит в USDT, BTC, ETH или другой из 30+ монет, оплаченный заказ сам получает счёт-фактуру Magento, а деньги уходят прямо на ваши кошельки.

Magento
от 2.4.4 до 2.4.9
PHP
от 8.1 до 8.5
Модуль
бесплатный, OSL 3.0

Что даёт модуль

  • Оплаченный заказ сам получает счёт-фактуру

    Как только платёж подтверждён, модуль создаёт оплаченный счёт-фактуру Magento с номером счёта CoinsPay в транзакции, и заказ переходит в обработку (Processing). Каждое событие добавляет в историю заказа комментарий с суммой, монетой и хешем транзакции, покупатель его не видит.

  • Деньги сразу на ваших кошельках

    CoinsPay не держит выручку у себя: каждая оплата уходит на ваши кошельки по правилу выплат магазина. В каждой сети до 5 адресов с долями, например 70 % вам и 30 % партнёру.

  • Цены остаются в валюте магазина

    Счёт выставляется в валюте заказа, а если CoinsPay её не принимает — в базовой валюте магазина. CoinsPay пересчитает итог в монету по текущему курсу и удержит сумму 30 минут, пока покупатель открывает кошелёк.

  • Ключ, которым нельзя вывести деньги

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

Подключение в четыре шага

Нужны кабинет CoinsPay с магазином и доступ к админке Magento. Установка — две команды на сервере, как у любого модуля Magento.

  1. 01Установите модульВыполните composer require coinspay/coinspay-magento и bin/magento setup:upgrade. Без Composer распакуйте архив с GitHub в app/code/CoinsPay/Payment и выполните ту же команду.
  2. 02Вставьте ключОткройте «Магазины → Конфигурация → Продажи → Способы оплаты → CoinsPay». В кабинете CoinsPay выпустите ключ в разделе «Ключи API» с доступом «Только счета» и вставьте его в поле «Ключ API».
  3. 03Подключите вебхукСкопируйте адрес вебхука из настроек модуля в раздел «Вебхук» кабинета, а ключ подписи whsec_ — обратно в модуль.
  4. 04Проверьте и сохранитеКнопка «Проверить подключение» покажет имя вашего магазина в CoinsPay. Проверьте статусы в группе «Статусы заказа» и сохраните: способ оплаты уже в оформлении заказа.
Настройки модуля CoinsPay в админке Magento: ключ API, адрес вебхука и успешная проверка подключения

Модуль справляется и с неудобными случаями

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

  • Платёж в пути

    Пока сеть подтверждает платёж, в историю заказа добавится комментарий с суммой и хешем транзакции. Заказ ждёт в состоянии Pending Payment, пока платёж не подтвердится.

  • Недоплата

    Если пришло меньше, к заказу добавится комментарий, сколько получено и сколько осталось, а покупатель доплатит на той же странице оплаты. Если счёт истёк частично оплаченным, заказ встанет на удержание, решение за вами.

  • Счёт истёк

    Время на оплату задаётся в настройках, от 15 минут до суток. Неоплаченный заказ отменится, и Magento вернёт товар на склад. Настройки предупредят, если Magento отменяет ожидающие заказы раньше этого срока.

  • Отмена в магазине

    Отмените заказ или дайте Magento отменить старый неоплаченный, и его счёт в CoinsPay тоже отменится: оплатить его будет нельзя. Платёж за отменённый заказ или не на ту сумму ставит заказ на удержание со статусом «Проверка криптоплатежа».

  • Оплата позже

    Покупатель, закрывший страницу оплаты, найдёт кнопку «Перейти к оплате» на странице заказа в личном кабинете, пока счёт открыт. Вернувшийся без оплаты может сложить товары обратно в корзину.

  • Ни один платёж не потеряется

    Вебхуки приходят с подписью, и модуль её проверяет. Если вебхук не дошёл, cron Magento раз в 5 минут спрашивает CoinsPay об открытых счетах, а кнопка «Обновить» на странице заказа делает это сразу.

  • Комиссию может платить покупатель

    Включите эти настройки, и комиссия CoinsPay и комиссия сети прибавятся к сумме в монете на странице оплаты. Итог заказа в магазине останется прежним.

  • Несколько сайтов

    Ключ и секрет вебхука задаются для каждого сайта: сайты могут работать с одним магазином CoinsPay или каждый со своим. Название способа оплаты задаётся для каждой витрины, на её языке.

  • Тестовый режим

    С тестовым ключом cpk_test_ счёт оплачивается кнопкой на странице оплаты, монеты не двигаются. Способ оплаты видит только тестовый покупатель, настоящие покупатели его не заметят.

Установка

Один пакет подходит к Magento Open Source и Adobe Commerce от 2.4.4 до 2.4.9. Поставьте его через Composer или распакуйте архив с GitHub в app/code — там же лежит исходный код.

Документация API
Magento
Open Source и Adobe Commerce от 2.4.4 до 2.4.9
Оформление заказа
стандартное оформление Magento (Luma)
PHP
от 8.1 до 8.5, на Magento 2.4.4 и 7.4
Лицензия
OSL 3.0

Платите, только когда получаете деньги

  • Первые 10 дней без комиссии, на выплаты до $500
  • Без абонентской платы и платы за подключение
  • Комиссию можно включить в счёт покупателя
  • Комиссия сети по факту, без наценки

от0,3 %с выплаты, ставка зависит от оборота

Подключить магазинКак считается комиссия

Вопросы о модуле

Все вопросы
Сколько стоит модуль?

Модуль бесплатный. Вы платите только комиссию CoinsPay с выплат: от 0,3 %, ставка снижается с ростом оборота, абонентской платы нет. Первые 10 дней после первого платежа выплаты до $500 идут без комиссии.

Какие монеты сможет выбрать покупатель?

Больше 30 монет и токенов в сетях TRON, Ethereum, BNB Smart Chain, Solana, Bitcoin и Litecoin: USDT, USDC, BTC, ETH, BNB, TRX, LTC, SOL и другие. В настройках модуля можно оставить только стейблкоины.

Почему заказ оформляется до оплаты?

Как с PayPal: Magento сразу создаёт заказ и резервирует товар, чтобы его не продали второй раз, пока сеть подтверждает платёж. Письмо о заказе уходит после оплаты, если вы не решите отправлять его сразу.

Модуль работает с Hyvä или headless-витриной?

Модуль встраивается в стандартное оформление заказа Magento, поэтому Luma и темы на её основе работают. Hyvä с запасным оформлением в стиле Luma тоже должна работать, но пока не проверена. Hyvä Checkout и headless-витрины (GraphQL, PWA Studio) пока не поддерживаются.

Нужен ли cron?

Magento без cron всё равно не работает, а модуль с его помощью раз в 5 минут спрашивает CoinsPay об открытых счетах на случай, если вебхук потерялся. Страница настроек предупредит, если cron молчит. В режиме обслуживания Magento не принимает вебхуки, проверка наверстает после.

Какие данные покупателя уходят в CoinsPay?

Номер заказа, сумма и валюта, названия и количество товаров и адрес, куда вернуть покупателя после оплаты. Имена, почта, адреса и телефоны покупателей в CoinsPay не передаются.

Можно подключить тестовую копию сайта?

Да, но заведите для неё отдельный магазин в CoinsPay. У магазина один адрес вебхука, и события пришли бы только на один из двух сайтов.

Начните принимать криптовалюту сегодня

Регистрация займёт минуту, настройка магазина ещё пять. За подключение платить не нужно.

Adobe, Adobe Commerce и Magento — зарегистрированные товарные знаки или товарные знаки Adobe в США и других странах. CoinsPay не связан с Adobe, а модуль не спонсирован и не одобрен этой компанией.