Which payment methods work with Hyvä?

How payments work with Hyvä

Hyvä is a frontend theme and checkout layer on top of Magento 2. It doesn’t process payments itself; instead, it talks to the same Magento payment methods and gateways you already use, either through:

• Hyvä Checkout – commercial checkout built for Hyvä Theme.
• Luma checkout via theme fallback – keeps standard Magento/Luma checkout and its payment modules.
• Hyvä React Checkout – open-source React-based checkout toolbox.

So the real question is not “Does Hyvä support PayPal / Stripe / X?” but “Is there a compatible checkout integration or adapter for my gateway?”. In most cases the answer is yes, but the integration path differs per stack.

Payment methods that work with Hyvä (by scenario)

1. Using Luma checkout with Hyvä (theme fallback)

If you keep Luma checkout using Hyvä’s Luma fallback, any payment method that works with standard Magento checkout keeps working:

• Magento core methods (Check/Money Order, Bank Transfer, Cash on Delivery, Purchase Order).
• PSP extensions that already integrate with Luma checkout (PayPal, Braintree, Klarna, etc.).
• Most existing one-step checkout gateways that render on Luma layouts.

This is the “safest” migration path: Hyvä powers catalog & CMS, while checkout + payments remain exactly as before.

2. Hyvä Checkout – supported gateways & methods

Hyvä Checkout works via integrations (modules) for each PSP. Official material and ecosystem docs highlight support for, for example:

Exact coverage varies per module and version. Always check the Hyvä Checkout payment integration list and your PSP’s docs for up-to-date details.

3. Hyvä React Checkout – payments

Hyvä React Checkout is an open-source React checkout. It:

• Supports Magento offline payment methods (Check / Money order, Bank transfer, Cash on delivery, Purchase order).
• Can integrate online gateways (PayPal, Stripe, etc.) through React payment components and dedicated modules.
• Is more of a “toolbox” than plug-and-play, so custom React work is expected.

4. Types of payment methods you can run on Hyvä

• Credit/debit cards – via PSPs like Stripe, Adyen, Braintree, Buckaroo, Razorpay, etc.
• Digital wallets – PayPal, Apple Pay, Google Pay, Amazon Pay (where the PSP supports Hyvä).
• Buy now, pay later & local methods – e.g., Klarna, iDEAL, Bancontact, SOFORT, GiroPay, UPI, etc.
• Offline methods – bank transfer, COD, purchase order, check/money order.
• Region-specific gateways – Razorpay, PayU, Payon, others via Hyvä-specific adapters or Luma fallback.

In practice, if there is a Magento 2 module for a gateway, you either use a Hyvä Checkout/React adapter or run it through Luma checkout fallback.

Steps to connect a payment method to Hyvä

Use this process whenever you want to add or verify a payment method for a Hyvä-powered Magento store.

1. Decide which checkout you’re using
   Clarify if your store will run on:
   • Hyvä Checkout (recommended for performance).
   • Luma checkout via theme fallback (minimal change approach).
   • Hyvä React Checkout (for custom React flows).
2. Find the right payment extension
   Search for:
   • A Magento 2 module from the payment provider (Stripe, Mollie, Adyen, Razorpay, etc.).
   • A Hyvä Checkout or Hyvä React adapter module for that provider, if your stack uses those checkouts.
   • Vendor notes or tags like “Hyvä Checkout ready”, “Hyvä compatible”, or “Hyvä React Checkout”.
3. Install the gateway (and Hyvä adapter) via Composer
   From your Magento root, require the payment module and its Hyvä adapter, then run setup + deployment commands.
4. Configure the payment methods in admin
   In Stores → Configuration → Sales → Payment Methods, enable the new method(s), add API keys/credentials, and define allowed countries, currencies, and order statuses.
5. Test all flows on a staging environment
   Place test orders with each payment method (guest and logged-in), validate callbacks/webhooks, and confirm that the order status and invoices are correct.
6. Monitor logs and metrics after go-live
   Once live, keep an eye on Magento logs, PSP dashboards, and analytics for failed payments and checkout drop-offs.

# From your Magento 2 root

# 1) Install the payment provider's Magento 2 module
composer require vendor/payment-gateway-magento2

# 2) Install the Hyvä Checkout adapter for that gateway (if applicable)
composer require vendor/payment-gateway-hyva-checkout

# 3) Upgrade and deploy
bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento setup:static-content:deploy -f

# 4) Flush caches
bin/magento cache:flush

Important notes: Hyvä Checkout, React Checkout, and Luma fallback

1. Hyvä Checkout payment API

Hyvä Checkout exposes a dedicated payment integration API. It’s flexible enough to support virtually any payment scenario, but each PSP integration is implemented as its own module, so coverage grows over time rather than all at once.

2. Hyvä React Checkout payment components

Hyvä React Checkout renders payment methods as React components. Basic methods work out of the box, but most modern PSPs need custom components or official React adapters. This gives you full UX control but requires React skills.

3. Luma fallback as a safety net

If a critical payment integration does not yet have a Hyvä Checkout / React adapter, you can keep it running through Luma checkout fallback while you migrate other parts of the site to Hyvä. This is common for complex PSP setups.

4. Magento Open Source vs Adobe Commerce

Payment compatibility is mostly the same across Magento Open Source and Adobe Commerce because gateways integrate at the checkout and order level. Commerce/B2B features (negotiated quotes, credit limits, etc.) can add extra flows but don’t change which PSPs you can use with Hyvä.

Verification checklist: are your payment methods really working with Hyvä?

Before you call a payment integration “done”, walk through this checklist on a staging or pre-production environment:

• Visibility: the payment methods you expect appear in checkout and have correct labels and icons.
• Guest flow: guest user can place orders successfully with each method.
• Logged-in flow: registered customer can reorder, use saved cards/wallets where applicable, and see orders in “My Account”.
• Totals & tax: order totals, tax, and discounts are correct after payment selection.
• Callbacks/webhooks: PSP status callbacks update Magento to the correct order state (paid, pending, failed).
• Edge cases: test failed payments, cancellations, and timeouts to confirm proper error messages and stock rollbacks.
• Logging & monitoring: no critical PHP errors or JS errors related to payments; PSP dashboard shows expected transactions.
• Performance: checkout stays fast; external PSP scripts don’t add excessive blocking time.

FAQs: Hyvä and payment methods