Robokassa

Платежи Robokassa для Medusa

Документация
Плагин Medusa для приёма платежей через Robokassa. Готов к продакшену.
Read README in English →

▶ Смотреть демо-видео

Возможности плагина

• Готов к продакшену: Проверен в боевых магазинах и готов к использованию в реальных проектах.
• Полная интеграция с Robokassa: Подключение к платёжной системе Robokassa для надёжной обработки платежей.
• Формирование чеков: Онлайн-чеки в соответствии с 54-ФЗ.
• Одно- и двухстадийная оплата: Автосписание или авторизация с холдированием.
• Возвраты и отмены: Возврат средств и отмена заказов.
• Вебхук-уведомления: Статусы платежей в реальном времени с проверкой подписи.
• Тестовый режим: Имитация оплаты без реальных списаний.
• Подробное логирование: Логи запросов и ответов для отладки и поддержки в режиме разработки.
• Полное тестовое покрытие: Юнит- и интеграционные тесты, покрывающие основные сценарии и граничные случаи.
• Пример витрины магазина: Готовый пример витрины на Next.js для использования как референс.
• Модуль интеграций : Настройте плагин прямо в приложении Medusa Admin — без редактирования конфигурационных файлов и повторного развёртывания магазина.

Модуль интеграций: Этот плагин поддерживает модуль интеграций — он позволяет администратору магазина настраивать его прямо в приложении Medusa Admin, не редактируя конфигурационные файлы и не выполняя повторное развёртывание магазина. Конфиденциальные значения шифруются, а настройки проверяются перед применением.

Что такое Robokassa

Robokassa — российский платёжный агрегатор, поддерживающий банковские карты, электронные кошельки, мобильные платежи, СБП и другие способы оплаты. Широко используется малым и средним бизнесом в России благодаря простой интеграции и широкому охвату платёжных методов.

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

Есть вопросы по плагину или идеи? Пишите в чат поддержки в Telegram — @gorgojs_chat

Общайтесь с другими разработчиками Medusa в Telegram — @medusajs_chat

Как мы тестируем, обновляем и исправляем плагин, читайте на странице Сопровождение.

Требования

• Medusa v2.17.2 или новее
• Node.js v22.23.4, v24.22.1, v26.12.1 или новее
• Аккаунт Robokassa — зарегистрируйтесь или войдите
• Модуль интеграций

Установка

123
yarn add @gorgo/medusa-integration @gorgo/medusa-payment-robokassa
# или
npm install @gorgo/medusa-integration @gorgo/medusa-payment-robokassa

Подключение

Зарегистрируйте плагин и Модуль интеграций в Copy to clipboardmedusa-config.ts:

1234567891011121314151617181920
const ROBOKASSA_INTEGRATION_ID = "robokassa-1"

module.exports = defineConfig({
  plugins: [
    {
      resolve: "@gorgo/medusa-integration",
      options: {
        encryptionKey: process.env.INTEGRATION_ENCRYPTION_KEY,
        providers: [
          {
            resolve: "@gorgo/medusa-payment-robokassa/providers/integration-robokassa",
            id: ROBOKASSA_INTEGRATION_ID,
            options: {},
          },
        ],
      },
    },
    {
      resolve: "@gorgo/medusa-payment-robokassa",
      options: {},

В Copy to clipboardINTEGRATION_ENCRYPTION_KEY задайте длинную случайную строку, например результат Copy to clipboardopenssl rand -hex 32. Из неё Модуль интеграций получает ключ, которым шифрует секретные параметры, например API-ключи.

Затем перезапустите сервер и настройте интеграцию в Medusa Admin в разделе Настройки → Интеграции → Robokassa.

Документация

Полное руководство по установке, настройке и использованию плагина доступно на сайте документации Gorgo.

Лицензия

Распространяется на условиях лицензии MIT.