Adyen

Для использования модуля оплаты Adyen необходимо выполнить настройки на стороне платёжной системы и подключить модуль в BILLmanager.

Настройка на стороне BILLmanager

Чтобы создать модуль оплаты, перейдите в раздел Провайдер → Методы оплаты → кнопка Создать. Мастер подключения модуля оплаты состоит из следующих шагов:

1. Выбор модуля оплаты: "Adyen".
2. Настройка интеграции. Укажите данные для интеграции:
   1. Тестовый режим — опция для работы с платёжным модулем в тестовом режиме. В этом режиме не происходит списание средств и все платежи выполняются успешно.
   2. Строка и имя компании — уникальный параметр вашей компании для формирования запросов к Adyen. Подробнее про формирование ссылок для API см. в статье Live endpoints документации Adyen.
   3. Аккаунт продавца — имя учётной записи продавцы на стороне Adyen. Подробнее про управление аккаунтами см. в статье Manage your account structure документации Adyen.
   4. Checkout API Key — уникальный ключ для подключения к API системы Adyen. Чтобы узнать ключ, на стороне платёжной системы перейдите в раздел Settings → Users и выберите нужного пользователя. Подробнее про API Key см. в статье How to get the Checkout API Key документации Adyen.
   5. Имя пользователя — значение, указанное на стороне Adyen в Authentication → User Name.
   6. Пароль — значение, указанное на стороне Adyen в Authentication → Password.
   7. Ключ HMAC — уникальная комбинация для шифрования, полученная на стороне Adyen в блоке настроек Addition Settings.
   8. Дата генерации HMAC в системе Adyen — дата, когда была выполнена настройка подписи HMAC в системе Adyen. Оставьте поле пустым, чтобы выполнялась проверка подписи для всех сообщений нотификации независимо от даты их создания.
   9. Рекуррентные платежи — опция для активации рекуррентных платежей через этот модуль. Рекуррентные платежи в BILLmanager используются для автоматического пополнения лицевого счёта и для создания подписок.
   10. Разрешить возврат платежей — опция для разрешения выполнять возврат средств через этот модуль.
3. Настройка метода оплаты. Настройте внутренние (в пределах BILLmanager) параметры метода оплаты. Подробнее см. шаг 3 в статье Настройка методов оплаты.

Настройка на стороне платёжной системы

Чтобы настроить автоматическую синхронизацию статусов платежей в Adyen и в BILLmanager:

1. Авторизуйтесь в личном кабинете Adyen.
2. Перейдите в Account → Server communication → блок настроек Transport.

3. В поле URL укажите адрес приёма уведомлений от платёжной системы: "billmgrURL/mancgi/adyennotify".

   Пояснение

   billmgrURL — публичный IP-адрес или домен сервера с BILLmanager.
4. Выберите SSL Version.
5. Включите опции Accept expired, Accept self-signed и Accept untrusted Root Certificates для корректной работы синхронизации.

6. Укажите User Name и Password в блоке Authentication. 

   Обратите внимание!

   Указанная комбинация нужна для настройки на стороне BILLmanager.

7. Чтобы шифровать уведомления при отправке, в блоке Addition Settings нажмите Generate new HMAC key. 

   Обратите внимание!

   Полученный ключ нужен для настройки на стороне BILLmanager.
8. В веб-интерфейсе BILLmanager:
   1. Перейдите в раздел Провайдер → Методы оплаты → кнопка Изменить.
   2. Активируйте опцию Принимать уведомления от Adyen.

Дополнительная информация

Возврат платежей

Для возврата платежей активируйте соответствующий флаг в настройках метода оплаты: Провайдер → Методы оплаты → Изменить → флаг Разрешить возврат платежей. Возврат поддерживается для платежей со статусом "Зачислен". 

Логирование

Логи взаимодействия биллинговой платформы с Adyen записываются в файлы:

• /usr/local/mgr5/var/pmadyen.log — лог-файл настройки модуля оплаты и возврата средств через него; 
• /usr/local/mgr5/var/adyenpayment.log — лог-файл оплаты; 
• /usr/local/mgr5/var/adyenresult.log — лог-файл получения ответа от платёжной системы. Отсутствует, если от платёжной системы не пришёл ни один ответ;
• /usr/local/mgr5/var/adyenrecurring.log — лог-файл настройки рекуррентных платежей. Отсутствует, если рекуррентный платеж не подключён; 
• /usr/local/mgr5/var/adyenrecresult.log — лог-файл получения ответа от платёжной системы при выполнении рекуррентных платежей. Отсутствует, если рекуррентный платеж не подключён;
• /usr/local/mgr5/var/adyennotify.log — лог-файл уведомлений о статусе платежей от Adyen. Отсутствует, если от платёжной системы не приходили уведомления.