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

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
Яндекс.Деньги.

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:

  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