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. Подробнее про управление аккаунтами см. в статье 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.
- Рекуррентные платежи — опция для активации рекуррентных платежей через этот модуль. Рекуррентные платежи в BILLmanager используются для автоматического пополнения лицевого счёта и для создания подписок;
- Разрешить возврат платежей — опция для разрешения выполнять возврат средств через этот модуль.
Синхронизация статусов платежей
Чтобы настроить автоматическую синхронизацию статусов платежей в Adyen и в BILLmanager:
- Авторизуйтесь в личном кабинете Adyen.
- Перейдите в Account → Server communication → блок настроек Transport.
В поле URL укажите адрес приёма уведомлений от платёжной системы: "billmgrURL/mancgi/adyennotify".
ПояснениеbillmgrURL — публичный IP-адрес или домен сервера с BILLmanager.
- Выберите SSL Version.
- Включите опции Accept expired, Accept self-signed и Accept untrusted Root Certificates для корректной работы синхронизации.
Укажите User Name и Password в блоке Authentication.
Обратите внимание!
Указанная комбинация нужна для настройки на стороне BILLmanager.
Чтобы шифровать уведомления при отправке, в блоке Addition Settings нажмите Generate new HMAC key.
Обратите внимание!
Полученный ключ нужен для настройки на стороне BILLmanager.
- На стороне 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