В этом руководстве вы узнаете, как просматривать и редактировать настройки интеграции Mollie в Medusa Admin через Модуль интеграций.

Чтобы открыть страницу с настройками Mollie:

1. Откройте Medusa Admin.
2. Перейдите в Настройки → Интеграции → Mollie.

Откроется страница настроек Mollie, где можно просматривать параметры доступа, способ списания и описание платежа.

---

В первой секции страницы можно изменить API-ключ и адрес вебхука. Ключ с префиксом test_ работает в тестовом режиме, ключ с префиксом live_ создаёт настоящие платежи. Где взять ключ, описано в разделе Подготовка аккаунта.

Чтобы отредактировать параметры доступа:

1. Перейдите в Настройки → Интеграции → Mollie.
2. В секции Доступы нажмите на меню действий в заголовке секции.
3. Выберите Редактировать.
4. В открывшейся боковой панели измените API-ключ и адрес вебхука. Формат адреса описан в разделе Настройка вебхуков.
5. Нажмите Сохранить.

Затем нажмите Проверить соединение. Кнопка запрашивает у Mollie профиль сайта, которому принадлежит API-ключ, поэтому неверный или отозванный ключ проверку не пройдёт. Не пройдёт она и для адреса вебхука, который начинается не с https:// или не содержит /hooks/payment/mollie_. При успешной проверке кнопка показывает режим ключа, test или live, а также название, ID и статус профиля.

---

Секция Поведение определяет способ обработки платежей и то, что покупатель видит о платеже.

Если выбрано Списать сразу, используется одностадийная оплата. Если выбрано Только заблокировать, используется двухстадийная оплата, и заблокированную сумму вы списываете из заказа в Medusa Admin. Заблокировать сумму могут только карты, Klarna, Billie, Riverty и ещё несколько способов. Авторизация по карте истекает через 7–30 дней в зависимости от платёжной системы карты, и Mollie её не продлевает.

Описание платежа покупатель видит на платёжной странице Mollie и в банковской выписке, длина до 255 символов. Если поле пустое, плагин подставляет слово Cart и ID корзины.

Чтобы отредактировать поведение оплаты:

1. Перейдите в Настройки → Интеграции → Mollie.
2. В секции Поведение нажмите на меню действий в заголовке секции.
3. Выберите Редактировать.
4. В открывшейся боковой панели измените способ списания и описание платежа.
5. Нажмите Сохранить.

---

Чтобы добавить платёжный провайдер Mollie, который будет отображаться на витрине:

1. Перейдите в Настройки → Регионы.
2. Выберите ваш регион.
3. В первой секции нажмите на меню действий в заголовке секции.
4. Выберите Редактировать.
5. В открывшемся модальном окне добавьте Mollie (MOLLIE) в платёжные провайдеры.
6. Нажмите Сохранить.

Тестовый режим Mollie принимает только EUR, поэтому тестируйте в регионе с евро. В live-режиме платёжная страница Mollie предлагает только способы, которые принимают валюту корзины.

---

Возвраты и отмены делайте из заказа в Medusa Admin. Плагин обрабатывает их в зависимости от состояния платежа в Mollie:

• Возврат. Оплаченный платёж можно вернуть по частям, в сумме не больше оплаченного. Mollie выплачивает возврат с вашего баланса Mollie асинхронно и ставит его в очередь, пока баланса не хватает. Если Mollie позже сообщит, что возврат не прошёл, плагин запишет предупреждение в лог, а заказ в Medusa по-прежнему покажет возврат. Платежи подарочными картами и paysafecard вернуть нельзя.
• Отмена авторизованного платежа. Плагин просит Mollie снять блокировку суммы. Mollie снимает её асинхронно.
• Отмена открытого платежа. Платёж, в котором покупатель ещё не выбрал способ оплаты, Mollie не отменяет. Плагин оставляет его открытым и пишет предупреждение в лог, а Mollie даёт ему истечь.
• Отмена оплаченного платежа. Плагин отказывает и предлагает сделать возврат.

Возврат или отмена, сделанные в Mollie Web App, в Medusa не попадают, и заказ сохраняет свои суммы.