Commerce · AMP

Integrating Stripe and PayPal in Liferay Commerce

Ankita Varani · Published Apr 12, 2026 · 9 min read · View full version

Quick answer

To integrate payment gateways, deploy Liferay's Stripe/PayPal connector, configure credentials (secret keys, client IDs) in Site Settings, set currency rules, and add the payment step to the Checkout Flow widget layout.

How Do You Configure Stripe and PayPal Gateway Credentials?

Direct Answer: Enter sandbox/production credentials (publishable keys, client IDs, secrets) inside Liferay Commerce's payment configuration console.

Log in to your gateway console (Stripe or PayPal) and generate API keys. In Liferay DXP, navigate to Commerce > Payment Methods. Select your gateway and paste the credentials. Keep sandbox modes enabled while testing checkouts.

For additional optimization strategies, visit our detailed Liferay DXP developer blog listing. For configuration specifications, consult the official Liferay Documentation portal.

Store API keys securely. Liferay encrypts keys before writing them to database tables, preventing credential leaks.

How Do You Add Payment Steps to Liferay Commerce Checkouts?

Direct Answer: Edit the checkout flow configuration. Add a payment step and map it to Stripe or PayPal interfaces using commerce tags.

Navigate to Site Settings > Checkout. Ensure the Payment Step widget is mapped. Style the payment form using Lexicon CSS to match the rest of your storefront. This maintains user trust and reduces cart abandonment rates.

For additional optimization strategies, visit our detailed Liferay DXP developer blog listing. For configuration specifications, consult the official Liferay Documentation portal.

When buyers proceed to checkout, Liferay renders payment forms, processing card details directly through provider token systems.

How Do You Verify and Secure Incoming Payment Webhooks?

Direct Answer: Configure webhook endpoints in Stripe or PayPal. Verify incoming request signatures using gateway secrets inside Liferay.

Transaction updates (like refunds or payments) require webhooks. Configure webhooks in Stripe to call Liferay. Secure these calls by registering webhook signing secrets to verify requests originate from Stripe, preventing fraudulent adjustments.

For additional optimization strategies, visit our detailed Liferay DXP developer blog listing. For configuration specifications, consult the official Liferay Documentation portal.

Validating signatures prevents request spoofing, ensuring order records are marked paid only after payment validation.

Frequently asked questions

Does Liferay Commerce support 3D Secure?

Yes. The Stripe connector supports 3D Secure 2 (3DS2) compliance, securing transactions against credit card fraud.

Can we configure custom checkout steps?

Yes. The Checkout Flow widget is modular, letting you rearrange checkout pages, shipping steps, and payment methods.

Read the full article, with table of contents, comparison table, and author bio →