Модуль интеграций позволяет любому плагину описывать свои параметры и даёт администраторам магазина настраивать их в Admin, без правок medusa-config и без передеплоя. UI, хранение, шифрование и валидацию модуль берёт на себя.

Модуль интеграций подойдёт разработчикам Medusa, которые создают плагины, провайдеры или кастомные модули с настраиваемыми параметрами (ключи API, учётные данные, режимы, вебхуки), но не хотят писать под каждый из них отдельную страницу UI, слой данных и валидацию.

• Управление настройками в Admin: Настройки задаются в разделе Настройки → Интеграции, без правок medusa-config/env и без передеплоя.
• Любой плагин, провайдер или модуль: Подходит для платежей, доставки, ERP, уведомлений, контента и другими расширениями.
• Декларативный дескриптор (defineIntegration): Единое описание параметров, секций настроек, валидации и проверки соединения.
• Гибкая типизация и валидация: Типизированные поля (string, url, email, uuid, number, boolean, enum, json) с правилами на уровне параметров и между секциями, условной видимостью и read-only-полями. В рантайме плагин получает типизированный расшифрованный объект: неполные или отключённые настройки не резолвятся, поэтому незаполненный черновик не будет возвращён.
• Шифрование секретов: Поля с пометкой secret шифруются (AES-256-GCM) и никогда не уходят в браузер.
• Несколько экземпляров: Один и тот же провайдер настраивается несколько раз. Например, для нескольких аккаунтов в одном стороннем сервисе.
• Проверка соединения: Тестирование подключения к сторонним сервисам из Admin.
• Расширяемый UI: Секции можно менять местами (LayoutComposer). Если готовых секций недостаточно, можно реализовать любой UI для своих параметров с помощью кастомных виджетов.
• Каталог интеграций: Доступные интеграции отображаются в Admin.

---

---

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

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