Magento 2 is a self hosted solution used by businesses around the world to build their e-commerce stores. Businesses can easily build and manage their online stores and customise them to their needs.

Our Super Payments widget enables Magento businesses to accept payments in a secure and hassle-free manner, whilst providing your customers with cash rewards and instant refunds on their purchases.

We recommend testing the Super Payments plugin on an isolated Magento test environment first, before adding to your live production storefront.

1. Add Your Cash Reward

Cash rewards are set per brand in the Business Portal and are optional. See Cash Rewards for how to choose a reward amount and expiry, or to turn rewards off.

2. Add Your Magento Integration

Once you are signed up, go to Developers → Integrations in the Business Portal and select Create new integration to add your e-commerce store URL.

3. Generate Your Magento Plugin API Keys

Generate your API keys in your Business Portal. You'll need your Confirmation ID and API key when you add your Super Payments plugin in the Magento admin interface. These keys keep your payments safe and secure.

4a. Install the Super Payments Magento Plugin

There are two ways to download the plugin:

The latest version (2.7.2) of the plugin can be found on our Github releases section here.

Compatible with Magento2 version >=2.4.8 and PHP >= 8.2.30

Option 1 - Download the plugin using Composer:

• Open the ssh terminal and go to root directory
• Run the following commands via the terminal to install the plugin

composer require superpayments/superpayment

Option 2 - Manually download the plugin:

• Download the plugin in the Magento Marketplace.
• Unzip the plugin zip and then move "app/code/Superpayments/SuperPayment" folder into Magento root directory.

You are now ready to Install the plugin:

• Run the following commands to install the plugin:

php bin/magento setup:upgrade
php bin/magento setup:di:compile
php bin/magento setup:static-content:deploy -f
php bin/magento cache:flush
php bin/magento cache:clean

The Super Payments module is now installed.

4b. Install the Super Payments Hyvä Magento Plugin

• Download the Hyvä plugin in the from here
• Unzip the plugin zip and navigate to the "app/code" directory.
• Create a folder named "Superpayments", then enter the newly created folder and create another folder named "SuperPaymentHyva".
• Go to the path "app/code/Superpayments/SuperPaymentHyva". Copy all folders and files from the "src" folder in the downloaded module.
• Run the following command:

php bin/magento hyva:config:generate

• Check the file "app/etc/hyva-themes.json" to ensure that the path to the Hyva compatibility module files is correctly specified. This is necessary for generating styles.
• Generate styles by executing the following commands:

npm --prefix vendor/hyva-themes/magento2-default-theme/web/tailwind/ run ci
npm --prefix vendor/hyva-themes/magento2-default-theme/web/tailwind/ run build-prod

• Run the following command:

php bin/magento setup:upgrade

• Configure the module in the admin panel.

The Super Payments Hyvä module is now installed.

Missing Hyvä Styles?

Make sure that PostCSS uses the postcssImportHyvaModules plugin in your theme:

• Go to your theme folder: app/design/frontend/<Vendor>/<Theme>/web/tailwind
• Install the module:

npm install --save-dev @hyva-themes/hyva-modules

• Open your postcss.config.js and add this as the first line:

const { postcssImportHyvaModules } = require("@hyva-themes/hyva-modules");

• Make sure the plugin is includes in the plugins list:

module.exports = {
    plugins: [
        postcssImportHyvaModules,
        // ...
    ],
};

5. Configure the Super Payments Plugin

• Sign in to your Magento Admin Panel
• Choose Stores -> Configuration -> Sales -> Payment Methods -> Super Payment
• Copy your Confirmation ID from your Super Payments Portal into the Confirmation ID field (PWH...)
• Copy your API key from your Super Payments Portal into the API key field (PSK...)
• Save your changes

6. Activate the Super Payments Plugin

Enabled Super Payments module by selecting Enabled -> Yes. Super Payments will appear as an option on your checkout. Set the Sort Order -> 1 so they Super Payments is top.

7. Enable the Super Payments Marketing Assets

Using Super Payments as a checkout method will ensure that shoppers will have a better shopping experience, increasing the likelihood that they’ll purchase from your store, increase their average order value and come back again.

Until shoppers reach your checkout, they’re not aware of the benefits that Super can provide. Letting them know early on in their shopping journey that Super is available as a checkout option through checkout messaging will help their purchase decision, knowing that they’ll get a cash reward for your store when they pay with Super Payments.

All the Marketing Assets should be enabled in the Magento Plugin settings.

Issuing Refunds from Magento

Go to Sales → Orders, open the order, then the Invoices tab. Open the invoice and select Credit Memo.

If you only see Refund Offline

This means Magento has no transaction to refund against, usually because the capture was never registered. Work through the following:

1. Check whether the invoice has a Transaction ID. This is also shown on the order's Transactions tab.
2. Check the order notes for Super Payment Webhook Status: PaymentSuccess. If it is missing, the webhook never processed.
3. Go to Stores → Configuration → Sales → Payment Methods → Super Payments and confirm Automatically Register Payment Capture is set to Yes, including at website scope.
4. Search var/log/system.log for [SP Webhook] RegisterCapture or SaveOrder errors around the time of the order.

If there is no transaction ID, refund the payment in the Business Portal, then select Refund Offline in Magento so its totals match.

Frequently Asked Questions

php bin/magento module:disable Superpayments_SuperPayment

composer remove superpayments/superpayment