Adyen

Liferay DXP 2024.Q3+/Portal GA125+

Liferay provides a client extension that integrates with Adyen. It uses the payment integration client extension as a base. See Configuring Payment Methods to read more about the payment methods available out-of-the-box with Liferay.

Note

Currently, the Adyen client extension is only compatible with Liferay SaaS.

Install the Adyen Client Extension

1. Log into your Liferay account at marketplace.liferay.com.

2. Search for Liferay Commerce Connector to Adyen and select it.

3. Click Get App.

4. Select your account and check the box to confirm you’ve read the End User License Agreement and the Terms of Service.

5. Click Get App.

   The app is ready for provisioning. Click Continue to Install to go the app’s App Provisioning page. Click Actions () → Install. You can also install the app by selecting View Details → Install.

   This page also has a Details tab where you can view the order details.

6. Select a project from the list. You cannot select projects that don’t have enough resources.

7. Choose an environment. You must have an environment that has an EXT prefix.

8. Click Install.

9. Log in as an administrator and verify that the OAuth Application User Agent and two OAuth Application Headless Servers were added to Liferay. Open the Global Menu () and go to Control Panel → OAuth2 Administration.

   

Verifying the Addition of Adyen as a Payment Method

1. Open the Global Menu () and go to Control Panel → Sites.

2. Add a new Minium site.

3. Open the Global Menu () and go to Commerce → Channels.

4. Select Minium Portal and scroll down to the Payment Methods section. Verify the addition of Adyen as a new payment method here. It is inactive by default.

5. Select the new payment integration and activate it using the Active toggle.

6. Click Save. Two new tabs, Eligibility and Configuration, appear for the payment integration.

   You can go to the Eligibility tab to select specific order types or payment terms to be eligible for the payment integration. By default, it is eligible for all order types and payment terms.

   The configuration tab contains an input field that accepts key-value pairs that you can find from your Adyen Customer Area.

   

   Field	Description
   apiKey	The API key from your Adyen dashboard.
   environment	Choose the environment (TEST or LIVE) for your integration.
   hmacSignature	Generate or use an existing HMAC key while setting up your webhook.
   merchantAccount	The name associated with your Adyen Merchant account.
   themeId	The ID of the theme created on Adyen.
   webhookPassword	The password to access the Adyen webhook.
   webhookUsername	The username to access the Adyen webhook.

   To set up the integration successfully, see Adyen’s integration checklist. You must also create a payment link theme on Adyen and copy its ID to use in the configuration above.

7. Click Save.

8. Open the site and use the account selector to create a new account.

9. Add a few items to your cart.

10. Open the mini cart and click Submit. This starts the checkout flow.

11. Continue checking out until you reach the order summary page. Click Continue to redirect to Adyen. Enter the necessary details and click Pay. After confirming payment, you’re automatically redirected back to Liferay. Open the Global Menu () and go to Commerce → Payments to verify the payment’s completion.

Note

The above flow uses Adyen’s test mode. Adyen provides numerous test card numbers to replicate different payment scenarios. See Test card numbers for more information.