Перейти к содержимому
ВойтиРегистрация

Принимайте криптоплатежи в своем магазине Medusa.js

Достаточно аккаунта Cryptonly и API-ключа. Установите плагин, включите его для региона — и магазин на Medusa сможет принимать криптовалюту. Ниже весь процесс настройки.

Как начать принимать криптоплатежи в Medusa

  1. Зарегистрируйте аккаунт Cryptonly

    Создайте мерчант-аккаунт в панели Cryptonly. Этот аккаунт выдаёт API-ключ, идентификатор аккаунта и ключ подписи вебхука, которые нужны в шагах ниже.

  2. Создайте API-ключ

    Создайте ключ, который может создавать, просматривать и отменять инвойсы: invoices.create, invoices.list и invoices.cancel. Сохраните ключ, идентификатор аккаунта и ключ подписи вебхука для конфига Medusa.

  3. Установите плагин Medusa

    Добавьте платёжный провайдер Cryptonly в приложение Medusa, затем зарегистрируйте @cryptonly/medusa-plugin-cryptonly/providers/cryptonly в medusa-config.ts, указав API-ключ, идентификатор аккаунта и ключ подписи вебхука. Пример конфига есть в руководстве по интеграции Medusa.

    npm install @cryptonly/medusa-plugin-cryptonly

  4. Начните принимать платежи

    Включите Cryptonly для региона в админке Medusa. Клиент платит на hosted-странице, а подписанный вебхук фиксирует платёжную сессию в Medusa, когда платёж подтверждается.

  5. Подключите витрину

    На оформлении заказа вызовите initiatePaymentSession и перенаправьте клиента на paymentPageUrl, который вернёт Cryptonly. Клиент платит на hosted-странице и возвращается в магазин.

Что такое Medusa

Medusa — открытый коммерческий фреймворк на Node.js. Магазин на нём состоит из headless-бэкенда и витрины, которой владеете вы, а не из готовой темы на чужом хостинге.

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

Cryptonly использует этот хук провайдера. Цены остаются в валюте магазина. Клиент платит на странице Cryptonly, а подписанный вебхук фиксирует сессию в Medusa, когда платёж подтверждается.

Какую криптовалюту можно принимать в Medusa с Cryptonly?

Все валюты
BitcoinBTC83 980,00 $+1,16%EthereumETH2 564,26 $+2,48%TetherUSDT0,999101 $-0,01%USD CoinUSDC1,0009 $+0,01%BNBBNB754,71 $+0,92%TRONTRX0,3320 $+0,52%ChainlinkLINK13,486 $+4,83%

Вопросы о Medusa

  • Какие версии Medusa поддерживает плагин?

    Medusa v2.8 или новее на Node.js 20 или новее. Провайдер подключается к платёжному модулю Medusa, поэтому приложения v1 не поддерживаются.

  • Нужно ли собирать свою страницу крипто-оплаты?

    Нет. Клиент платит на hosted-странице Cryptonly и возвращается в магазин. Экран кошелька и слежение за сетью делать не нужно.

  • Сколько это стоит?

    0,5% с каждого платежа, без платы за подключение.

  • Можно ли проверить плагин до реальных платежей?

    Да. В режиме песочницы проходят и hosted-страница, и вебхук, но деньги не двигаются. Песочницу выключают, когда магазин готов принимать живые платежи.

  • Цены товаров должны быть в криптовалюте?

    Нет. Каталог остаётся в валюте магазина. Cryptonly пересчитывает сумму в момент оплаты.

  • Как Medusa узнаёт, что заказ оплачен?

    Cryptonly отправляет подписанный вебхук на ваш бэкенд. Провайдер проверяет подпись, и Medusa фиксирует платёжную сессию.

Принимайте криптоплатежи с Medusa и Cryptonly

Hosted checkout, подписанные вебхуки и комиссия 0,5%. Medusa сама обновляет статус заказа, а каталог остаётся в фиате.