Adyen

To use the Adyen payment module,  register  in the payment system and configure the module on the BILLmanager side.

Payment methods support
Bank cards	Cash	E-wallets	Mobile payments	Online banking
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, Terminals.	Afterpay Touch, Alipay, Alipay HK, Doku Wallet, GCash, GrabPay, MasterPass, MOLPoints, MoMo Wallet, PayCo, PayMaya, Paytm, Swish, Vipps, WebMoney, WeChatPay, YooMoney.		Giropay, iDEAL, Interac Online, Japanese online bankng, Korean online banking, Malaysian online banking, Philippines online banking, POLi, Polish online banking, Trustly, Vietnamese online banking, Alpha-Click, Sberbank Online.
Supported features
Payments return		Recurring payments		Subscriptions

Configuring BILLmanager

To create a payment module, enter Provider → Payment methods → click Add. The payment module adding wizard consists of the following steps:

1. Select a payment methods: "Adyen".
2. Integration settings. Specify the data for integration:
   
   1. Test mode —  select the checkbox to activate a test mode for this payment method. The system won't charge the client but will process the payments correctly;
   2. String and company name — a unique name of your company that is used for requests to Adyen. Learn more under Live endpoints.
   3. Merchant account — the name of the Adyen merchant account. For more information please refer to the article Manage your account structure  
   4. Checkout API Key — a unique key to connect to Adyen API. To find the key, go to Settings → Users and select a required user. For more information about the API Key please refer to the article How to get the Checkout API Key in the Adyen documentation.
   5. Username — the value specified on the Adyen side in Authentication → User Name.
   6. Password — the value specified on the Adyen side in Authentication → Password.
   7. HMAC key — a unique encryption key obtained on the Adyen side in the Addition Settings settings block.
   8. HMAC generation date in Adyen — the date when the HMAC signature was configured in Adyen. Leave the field empty to verify the signature for all notification messages regardless of when they were created.
   9. Client groups and risk profiles — a setting for risk evaluation rules for the payment session. Select client groups and assign a risk profile from the available list to them. Specify the default profile for clients outside these groups.
   10. Recurring payments — an option to enable recurring payments through this module. Recurring payments in BILLmanager are used for automatic replenishment of the client area account.
   11. Allow refunds — an option to allow refunds through this module.
3. Payment method settings. Configure internal (within BILLmanager) parameters of the service payment module. For more details, see How to add a payment gateway module.

Configuration on the payment system side

To configure automatic synchronization of payment statuses in Adyen and BILLmanager:

1. Log in to the Adyen client area.
2. Go to Account → Server communication → the Transport settings block.

3. In the URL field, specify the address for receiving notifications from the payment system: billmgrURL/mancgi/adyennotify .

   Explanation

   • billmgrURL — the public IP address or domain of the server with BILLmanager.
4. Select SSL Version.
5. Enable the Accept expired, Accept self-signed, and Accept untrusted Root Certificates options for the synchronization to work correctly.

6. Specify User Name and Password in the Authentication block. 

   The specified combination is needed for configuration on the BILLmanager side.

7. To encrypt notifications when they are sent, in the Addition Settings block click Generate new HMAC key. 

   The resulting key is needed for configuration on the BILLmanager side.
8. In the BILLmanager web interface:
   1. Go to Provider → Payment methods → click Edit.
   2. Enable the Accept notifications from Adyen option.

Additional information

Refunds

To refund payments, enable the corresponding checkbox in the payment method settings: Provider → Payment methods → Edit → Allow refunds checkbox. Refunds are supported for payments with the status "Credited". 

Logging

Adyen has the following log files:

• /usr/local/mgr5/var/pmadyen.log — configuration details of the payment method and refunds;
• /usr/local/mgr5/var/adyenpayment.log — payment log;
• /usr/local/mgr5/var/adyenresult.log — responses from the payment gateway. The file is not present if no responses were received from the payment gateway; 
• /usr/local/mgr5/var/adyenrecurring.log — recurring payments log. The file is not present if recurring payments are not enabled;
• /usr/local/mgr5/var/adyenrecresult.log — responses from the payment gateway when recurring payments are activated. The file is not present if recurring payments are not enabled;
• /usr/local/mgr5/var/adyennotify.log — Adyen payment status notification log. The file is not present if no notifications were sent from the payment gateway.

Request parameters and API version

The platform sends additional data in requests to Adyen:

• shopperIP — client's IP address;
• shopperEmail — client's email address;
• accountInfo.accountCreationDate — client's registration date in the platform.