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

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

• Управление настройками в Admin: Задайте настройки в разделе Настройки → Интеграции, без правок medusa-config и без повторного развёртывания приложения Medusa.
• Любой плагин, провайдер или модуль: Подходит для платежей, доставки, 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