Adyen

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

Поддержка способов оплаты
Банковские карты	Наличные	Электронные кошельки	Мобильные платежи	Интернет-банкинг
American Express, Bancontact, CARNET, Cartes Bancaires, Diners, Discover, Elo, JCB, Hipercard, Korean cards, Maestro, Mastercard, Troy, Union Pay, Visa.	7-Eleven, Alfamart, Boleto, e-Pay, Indomaret, Multibanko, OXXO, Pay-easy, Paysbuy, терминалы оплаты.	Afterpay Touch, Alipay, Alipay HK, Doku Wallet, GCash, GrabPay, MasterPass, MOLPoints, MoMo Wallet, PayCo, PayMaya, Paytm, Swish, Vipps, WeChatPay		Giropay, iDEAL, Interac Online, Japanese online banking, Korean online banking, Malaysian online banking, Philippines online banking, POLi, Polish online banking, Trustly, Vietnamese online banking.
Поддерживаемые возможности
Поддержка ФЗ-54	Возврат платежей	Рекуррентные платежи		Подписки

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

Чтобы создать модуль оплаты, перейдите в раздел Провайдер → Методы оплаты → кнопка Создать: 

1. Выбор модуля оплаты: Adyen.
2. Настройка интеграции. Укажите данные для интеграции:
   1. Тестовый режим — опция для работы с платёжным модулем в тестовом режиме. В этом режиме не происходит списание средств и все платежи выполняются успешно.
   2. Строка и имя компании — уникальный параметр вашей компании для формирования запросов к Adyen. Подробнее про формирование ссылок для API см. в статье Live endpoints документации Adyen.
   3. Аккаунт продавца — имя учётной записи продавца на стороне Adyen. Подробнее про управление аккаунтами см. в статье Manage your account structure документации Adyen.
   4. Checkout API Key — уникальный ключ для подключения к API системы Adyen. Чтобы получить ключ, на стороне платёжной системы перейдите в раздел Developers → API credentials и выберите нужную запись учётных данных. Подробнее о получении ключа см. в статье документации Adyen.
   5. Имя пользователя — значение, указанное на стороне Adyen. Чтобы его узнать, перейдите в раздел Developers → API credentials, откройте нужную запись учётных данных и скопируйте значение Username.
   6. Пароль — значение, указанное на стороне Adyen. Чтобы его узнать, перейдите в раздел Developers → API credentials и откройте нужную запись учётных данных. Пароль отображается при создании новой записи или после его перегенерации с помощью кнопки Generate password.
   7. Ключ HMAC — уникальная комбинация для шифрования. Чтобы получить его, на стороне Adyen перейдите в раздел Developers → Webhooks. Ключ доступен для просмотра только при создании нового вебхука.
   8. Дата генерации HMAC в системе Adyen — дата, когда была выполнена настройка подписи HMAC в системе Adyen. Оставьте поле пустым, чтобы проверка подписи выполнялась для всех сообщений нотификации независимо от даты их создания.
   9. Группы клиентов и риск-профили — настройка правил оценки рисков для платёжной сессии. Выберите группы клиентов и назначьте им риск-профиль из доступного списка. Укажите профиль по умолчанию для клиентов вне этих групп.
   10. Рекуррентные платежи — опция для активации рекуррентных платежей через этот модуль. Рекуррентные платежи в BILLmanager используются для автоматического пополнения лицевого счёта.
   11. Разрешить возврат платежей — опция для разрешения выполнять возврат средств через этот модуль.
3. Настройки метода оплаты. Настройте внутренние параметры метода оплаты в BILLmanager. Подробнее см. шаг 3 в статье Настройка методов оплаты.

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

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

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

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

   Пояснение

   • billmgrURL — публичный IP-адрес или домен сервера с BILLmanager.
4. В поле Encryption protocol выберите значение в зависимости от версии SSL-сертификата: TLSv1.3 или TLSv1.2.
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. Отсутствует, если от платёжной системы не приходили уведомления.

Параметры запросов

Платформа передаёт в запросах к Adyen дополнительные данные:

• shopperIP — IP-адрес клиента;
• shopperEmail — адрес электронной почты клиента;
• accountInfo.accountCreationDate — дата регистрации клиента в платформе.