Configuring HPP integration
Adyen Hosted Payment Pages integration enables you to keep the payment pages that capture credit card information in Adyen. This method does not require SAQ-A declaration.
- Create a skin in Adyen. You create the default skin by logging in to the Adyen back office. Adyen support can help you create and customise your first skin.
- Enter the fields in the Litium.AddOns.Adyen.dll.config in your wwwroot folder. The fields are described at the beginning of the file.
Configuring capture
For the Adyen 1.1 release, the Adyen account should have Capture set to Manual from the backoffice. A future release will support automatic capture.
- Log in to Adyen back office.
- Go to Accounts and select the merchant account.
- Go to Settings > Merchant settings and set the Capture Delay to Manual.
Configuring server communication
Adyen server communication allows Adyen to report the payment statuses to Litium using a server-to-server background call.
Important: Note that server communication is a required component for Adyen AddOn to work properly. If server communication is not working, Authorization calls may result in wrong statuses in Litium and Capture, Cancel and Refund calls will not update the Litium payment status correctly.
- Log in to Adyen back office.
- Go to Accounts and select the merchant account.
- Go to Settings > Server Communication and add a standard notification with the following settings:
- Url: https://<your domain name>/PaymentProviderResult.axd/Report/Adyen
- SSL version: 1.2
- Method: HTTP POST
Test the settings to make sure there are no communication failures.
You may receive additional information about transactions through server communication. The additional information is saved into the AdditionalPaymentInfo of the payment.
To configure, choose which additional information you would require from:
https://docs.adyen.com/developers/notifications/set-up-notifications/additional-settings
It is possible to restrict the payment methods available to the end customers from the skin in Adyen. In Adyen administration backoffice, for your skin, simply restrict the payment methods that you do not want to be available to the end customers using that skin.
Selecting credit card and direct bank payments from the checkout page
If you would like the end customers to select whether to use credit cards or direct bank payment from the checkout page (before going into Adyen), simply have two skins at Adyen with one allowing credit cards and the other direct bank payments. Then in the Adyen add-on configuration, create two different accounts sections with different paymentAccountIdentifiers and respective skin codes.
Saving credit card information for one-click payments
Logged in users can save the credit card information for one click payments so that they do not have to enter the credit card details again when they buy next time.
There are two methods:
- If you set recurringContractType="ONECLICK" in the Litium.AddOns.Adyen.dll.config, when using HPP method, the card is saved at the Adyen site, and there are no modifications needed to the checkout page.
- If you use recurringContractType="RECURRING", you need to modify the checkout page and populate the users saved card list.
When using the SDK method, only ONECLICK is supported.
It is possible to have multiple Adyen accounts in the same Litium installation.
To add a new Adyen account, in the Litium.AddOns.Adyen.dll.config file
- create a new paymentAccount section (copy paste an existing paymentAccount section)
- change paymentAccountIdentifier attribute. It should be unique and should not contain spaces.
The paymentAccountIdentifier is appended at the begining of each Adyen payment method, and is used by the API to identify the correct account.
You may also use a single Adyen merchant account, and different addon PaymentAccount sections with different PaymentAccountIdentifiers, to share the same Adyen account between multiple channels in Litium.
Testing
Test cards
Information about test cards can be found here >>.
Trace mode
To view the communication between Litium and Adyen, set the tracemode attribute in Litium.Addons.Adyen.dll.config file to true.