Adyen

Поддержка способов оплаты
Банковские карты	Наличные	Электронные кошельки	Мобильные платежи	Интернет-банкинг
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, QIWI Wallet, Swish, Vipps, WebMoney, WeChatPay ЮMoney.		Giropay, iDEAL, Interac Online, Japanese online bankng, Korean online banking, Malaysian online banking, Philippines online banking, POLi, Polish online banking, Trustly, Vietnamese online banking, Альфа-Клик, Промсвязьбанк, Сбербанк онлайн.
Поддерживаемые возможности
Поддержка ФЗ-54
Возврат платежей
Рекуррентные платежи
Подписки

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

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

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

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

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

• Тестовый режим — опция для работы с платёжным модулем в тестовом режиме. В этом режиме не происходит списание средств и все платежи выполняются успешно; 
• Checkout API Key — уникальный ключ для подключения к API системы Adyen. Чтобы узнать ключ, на стороне платёжной системы перейдите в раздел Settings → Users и выберите нужного пользователя. Подробнее про API Key см. в статье How to get the Checkout API Key документации Adyen; 
• Аккаунт продавца — имя учётной записи продавцы на стороне Adyen. Подробнее про управление аккаунтами см. в статье Manage your account structure документации 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. 
• Рекуррентные платежи — опция для активации рекуррентных платежей через этот модуль. Рекуррентные платежи в BILLmanager используются для автоматического пополнения лицевого счёта и для создания подписок; 
• Разрешить возврат платежей — опция для разрешения выполнять возврат средств через этот модуль.

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

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