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

Adyen

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


Модуль оплаты подключается в разделе Провайдер → Методы оплатыМастер подключения состоит из трёх шагов:

  • Шаг 1 — Выбор метода оплаты. В качестве метода оплаты выберите "Adyen"; 
  • Шаг 2 — Настройка интеграции. Введите информацию, необходимую для интеграции с платёжной системой; 
  • Шаг 3 — Настройка метода оплаты. Настройте внутренние (в пределах BILLmanager) параметры метода оплаты. 

Настройка интеграции

Укажите следующие параметры: 

  • Тестовый режим — опция для работы с платёжным модулем в тестовом режиме. В этом режиме не происходит списание средств и все платежи выполняются успешно; 
  • Checkout API Key — уникальный ключ для подключения к API системы Adyen. Чтобы узнать ключ, на стороне платёжной системы перейдите в раздел Settings → Users и выберите нужного пользователя. Подробнее про API Key см. в статье How to get the Checkout API Key документации Adyen; 
  • Аккаунт продавца — имя учётной записи продавцы на стороне Adyen. Подробнее про управление аккаунтами см. в статье Company and merchant accounts документации Adyen; 
  • Строка и имя компании — уникальный параметр вашей компании для формирования запросов к Adyen. Подробнее про формирование ссылок для API см. в статье Live endpoints документации Adyen; 
  • Библиотека шифрования — имя уникальной библиотеки js. Библиотека нужна для работы автоматических платежей через Client-Side Encryption. Сгенерируйте имя библиотеки на стороне Adyen в разделе Settings → Users → ws@company.<имя вашей компании> → Easy encryption. Подробнее про шифрование на клиентской стороне см. в статье Client-Side Encryption документации Adyen; 
  • Принимать уведомления от Adyen — опция для работы с уведомлениями от платёжной системы. Позволяет настроить синхронизацию статусов платежей. Подробнее см. в текущей статье в разделе Синхронизация статусов платежей. Если опция активна, то укажите дополнительную информацию:
    • Имя пользователя — значение, указанное на стороне Adyen в Authentication → User Name;
    • Пароль — значение, указанное на стороне Adyen в Authentication → Password;
    • Ключ HMAC — уникальная комбинация для шифрования, полученная на стороне Adyen в блоке настроек Addition Settings
  • Рекуррентные платежи — опция для активации рекуррентных платежей через этот модуль; 
  • Разрешить возврат платежей — опция для разрешения выполнять возврат средств через этот модуль. 

Синхронизация статусов платежей


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

  1. Авторизуйтесь в личном кабинете Adyen.
  2. Перейдите в Account → Server communication → блок настроек Transport.
  3. В поле URL укажите адрес приёма уведомлений от платёжной системы: "billmgrURL/mancgi/adyennotify".

     Пояснение

    billmgrURL — публичный IP-адрес или домен сервера с BILLmanager.

  4. Выберите SSL Version.
  5. Включите опции Accept expiredAccept self-signed и Accept untrusted Root Certificates для корректной работы синхронизации.
  6. Укажите User Name и Password в блоке Authentication

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

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

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

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

    Полученный ключ нужен для настройки на стороне BILLmanager.

  8. На стороне BILLmanager включите опцию Принимать уведомления от 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. Отсутствует, если от платёжной системы не приходили уведомления. 

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

Если платёж завершился с ошибкой и файл adyenresult.log отсутствует, то вы можете отследить проблему в лог-файлах /usr/local/mgr5/var/pmadyen.log и /usr/local/mgr5/var/adyenpayment.log