Installing Payment Methods From Marketplace

Liferay DXP 2025.Q2+/Portal GA135+

Warning

This feature is only available for Liferay Cloud projects (SaaS or PaaS) connected to a valid Liferay Cloud account, and only free apps are available in the Marketplace Explorer.

You can install cloud payment method apps directly from the Liferay Marketplace to enhance your Liferay Commerce storefront. This feature expands your store’s capabilities and improves the checkout experience for customers.

Before you begin, ensure that your Liferay DXP instance is connected to the Marketplace.

Setting up Marketplace

Set up a connection between Liferay DXP and Marketplace.

Connect Liferay DXP to Marketplace to install payment methods from Marketplace directly.

Ensure the user has permission to install apps from Marketplace.

While defining role permissions, go to the Defining Permissions tab and add the permissions below:

Location	Permission	Use
Marketplace → General	Get Authorization	Required to connect to Marketplace and view available apps.
Marketplace → Payment Methods	View Apps	Shows the Marketplace button in the interface.
Marketplace → Payment Methods	Install Free/Bundled Apps	Allows installation of free payment method apps (includes View Apps implicitly).

Accessing the Marketplace Explorer

Open the Global Menu (), go to the Commerce tab, and click Channels under Store Management.
Select the channel where you want to add the payment method.
Under Payment Methods, click Add next to the Marketplace icon ().

If you haven’t set up marketplace, you are prompted to do so. Otherwise, the Add from Marketplace modal appears.

Installing Payment Method Apps

Important

Ensure you have a cloud project with the necessary resource requirements to install the payment method.

Access the Marketplace explorer.
Select a payment method and click Install.

The Install button is disabled for apps that are already installed.
(Optional) Click the payment method’s card to view details such as the developer’s name, published date, and supported versions.
Click Install. The installation happens in the background, so you can perform other tasks while you wait.

Once installed, the payment method appears under the Payment Methods list.

Uninstalling Payment Method Apps

Open the Global Menu (), go to the Commerce tab, and click Channels under Store Management.
Click Actions () for the method you want to uninstall → Uninstall.
Confirm the action by clicking Confirm & Uninstall.

The app and all related services are removed from Liferay DPX. Ensure you are uninstalling the correct app.