Миграция плагина ЮKassa в скоуп @gorgo

Плагин приёма платежей через ЮKassa для Medusa переехал в монорепозиторий medusa-plugins и теперь публикуется как @gorgo/medusa-payment-yookassa. Функциональность плагина осталась прежней, однако процессы его разработки и поддержки стали значительно надёжнее.

Что такое ЮKassa

ЮKassa - сервис интернет-эквайринга от Яндекса. Позволяет интернет-магазинам принимать оплату картами, через СБП, SberPay, Mir Pay, ЮMoney и другими способами. Подробнее на сайте ЮKassa.

Зачем мы перенесли плагин

Все плагины для Medusa мы объединяем в одном монорепозитории. Это дает несколько преимуществ:

• Все плагины интеграций в одном месте: Единая кодовая база, общий инструментарий и одинаковые требования к качеству для всех пакетов @gorgo/*.
• Ежедневный прогон тестов: Каждый плагин ежедневно проходит юнит-, интеграционные и контрактные тесты с API интегрируемых сервисов, а также проверяется на совместимость с актуальным релизом Medusa. Это позволяет нам выявлять проблемы раньше, чем с ними столкнётесь вы.
• Ускоренная поддержка и развитие: Исправления и новая функциональность доходят до релиза быстрее, а обработка ваших вопросов и сообщений об ошибках становится проще.

Что изменилось

Для вас как пользователя меняется только имя пакета. Набор опций и функциональность плагина остались прежними. Подробнее обо всех возможностях читайте в документации.

При этом мы сделали плагин надёжнее. Мы покрыли его тестами и наладили ежедневную проверку совместимости с последней версией Medusa и актуальным API ЮKassa.

Изменения в пакете
1- medusa-payment-yookassa           # было
2+ @gorgo/medusa-payment-yookassa    # стало

Старый пакет medusa-payment-yookassa помечен как устаревший (deprecated). Он остаётся в npm до конца 2026 года, но больше не будет поддерживаться. Чтобы и дальше получать обновления, рекомендуем перейти на новый пакет уже сейчас.

Как мигрировать

Миграция сводится к смене названия пакета и его переустановке.

Шаг 1. Установите новый пакет

npm install @gorgo/medusa-payment-yookassa

Шаг 2. Обновите medusa-config.js

Замените путь к провайдеру на новый с префиксом @gorgo/ в файле medusa-config.js:

medusa-config.js
1module.exports = defineConfig({
2  // ...
3  modules: [
4    {
5      resolve: "@medusajs/medusa/payment",
6      options: {
7        providers: [
8          {
9            resolve: "@gorgo/medusa-payment-yookassa/providers/payment-yookassa",
10            id: "yookassa",
11            options: {
12              // ... те же опции
13            },
14          },
15        ],
16      },
17    },
18  ],
19})

Шаг 3. Удалите старый пакет

npm uninstall medusa-payment-yookassa

На этом миграция завершена, никаких других изменений не требуется. Подробное руководство по установке и настройке доступно в документации.

Поддержка и сообщество Medusa в Telegram

Задавайте вопросы и обсуждайте Medusa в Telegram-сообществе, пишите о проблемах с плагином в чат поддержки Gorgo или открывайте Issues и Pull Requests на GitHub.