Installing and Using the Liferay Commerce Connector to Stripe Tax App

Liferay DXP 2025.Q2+

Liferay provides a cloud-based Stripe tax connector app that is based on the Tax Engine Client Extension to calculate taxes during checkout. After installing the app, you can activate it in a Commerce Channel and connect it to your Stripe account using an API key.

Note

The Liferay Commerce Connector to Stripe Tax client extension is available for Liferay SaaS as a deployable cloud app and for Liferay PaaS and Self-Hosted environments as a downloadable Client Extension.

Installing the App

Log into your Liferay account at marketplace.liferay.com.
Search for Liferay Commerce Connector to Stripe Tax and select it.
Click Get App.
Select your account and check the box to confirm you’ve read the End User License Agreement and the Terms of Service.
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.

Tip

For Liferay PaaS and Self-Hosted environments, download the client extension manually from the Download tab in Marketplace. Click Download for the desired version, then deploy it to your environment. See Using Client Extensions for deployment instructions.
Select a project with enough available resources.
Choose an environment that begins with the EXT prefix.
Click Install.

Verifying Installation

Log in as an administrator.
Open the Global Menu () and go to Control Panel → OAuth2 Administration. The Liferay Stripe Commerce Tax Engine OAuth Application User Agent appears in the list.

Using the App

Open the Global Menu () and go to Control Panel → Sites.
Add a new Minium site.
Open the Global Menu () and go to Commerce → Channels.
Select Minium Portal and scroll down to Tax Calculations. Verify the Liferay Stripe Commerce Tax Engine appears. It is inactive by default.
Select the new tax calculation engine and activate it using the Active toggle.
Click Save. Two new tabs, Tax Category Mappings and Configuration, appear for the payment integration.
Select the Configuration tab and enter an API key that you can obtain from your Stripe Dashboard.
Select the Tax Category Mappings to map existing tax categories to Stripe’s tax codes.

For example, if you have a tax category called Services and you want to map it to Stripe’s General - Services category, copy the Tax Code for the category you want (in this case, txcd_2003000), paste it under Mapping, and click Submit.
Click Save.
Open the Minium site and use the account selector to create a new account.
Add a few items to your cart.
Open the mini cart and click Submit. This starts the checkout flow.
Continue checking out until you reach the order summary page. The Tax value is calculated using Stripe.