Additional modules
Extend the Buckaroo Magento 2 plugin with optional modules for alternative frontends and headless storefronts.
Each module is a separate Composer package that sits on top of the base plugin. Install the base plugin first; none of these work standalone.
Looking for Second Chance or Google Analytics? Those are features of the main plugin, not separate modules. See Built-in features.
Which module do I need?
| If your store... | Install |
|---|---|
| Uses the standard Luma checkout | Nothing extra |
| Uses Hyvä Checkout | Hyvä Checkout module |
| Is headless or a PWA | GraphQL module |
| Uses Hyvä React Checkout | GraphQL module and Hyvä React Checkout module |
Hyvä Checkout and Hyvä React Checkout are two different products and need different modules. Hyvä Checkout is the more widely used of the two. Check which one your store runs before installing, because the modules are not interchangeable.
Hyvä Checkout module
Hyvä is a lightweight Magento frontend built for speed. This module adds Buckaroo support to Hyvä Checkout, so you get Buckaroo's payment methods with Hyvä's performance. Loading is significantly faster, especially on mobile, which typically translates into better checkout conversion.
Use this if your store runs Hyvä Checkout.
composer require buckaroo/magento2-hyva-checkoutRequires plugin version 2.4.0 or later.
Hyvä React Checkout module
Adds Buckaroo payment support to Hyvä React Checkout, the React-based checkout for Magento SPA and PWA storefronts. It suits teams with React experience who want a headless frontend while Magento keeps handling the payment logic.
Unlike the other modules, this one is not a Composer package. It's a payment method package for the React app, added through npm.
Requirements
This module sits on top of two others, both of which must be installed and configured first:
| Why | |
|---|---|
| Buckaroo Magento 2 plugin | Handles the payments |
| GraphQL module | Exposes the payment methods to the headless frontend |
You also need the Hyvä React Checkout codebase itself.
Install
Add the repository to the paymentMethodsRepo entry in your Hyvä module's reactapp/package.json:
"config": {
"paymentMethodsRepo": {
"buckaroo": "[email protected]:buckaroo-it/Magento2_Hyva.git"
}
},Then rebuild the React app:
npm i
npm run buildUpgrade
Pull the latest changes and rebuild:
cd Hyva/CheckoutExample/reactapp/src/paymentMethods/buckaroo
git pull
cd Hyva/CheckoutExample/reactapp
npm run buildGraphQL module
Exposes Buckaroo's payment functionality through Magento's GraphQL API, so you can build your own checkout on a headless or PWA storefront while Magento and Buckaroo handle the payment logic.
composer require buckaroo/magento2graphqlRepository · Documentation · Headless and GraphQL guide · Headless and GraphQL guide
Updated 4 minutes ago