Adyen

Liferay DXP 2024.Q3+/Portal 7.4 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 and Deploy the Adyen Client Extension

1. Go to the Liferay Marketplace and search for Liferay Commerce Connector to Adyen.

2. Click Get App, select your account or create one, and accept the end user license agreement and terms of service.

3. Click Continue.

4. Select a project from the ones available to you.

5. Click Get App.

6. Note the order ID. You must use it to install the app from your Cloud dashboard.

7. Click Go to Console.

8. Go to Services, and click New App.

9. Enter the order ID from before and complete the installation.

10. 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.