MultiSafepay plugin for Magento 2 (Frontend module)

ℹ️ This is the frontend module of our Magento 2 plugin.
For a complete installation of all our features, please check out our meta package.

Installation

This module can be installed via composer:

composer require multisafepay/magento2-frontend

Next, enable the module and its dependant modules:

bin/magento module:enable MultiSafepay_ConnectCore MultiSafepay_ConnectFrontend MultiSafepay_ConnectAdminhtml

Next, run the following commands:

php bin/magento setup:upgrade
php bin/magento setup:di:compile
php bin/magento setup:static-content:deploy

Please keep in mind that after installing this module, you will not have proper stock handling.

For a quick installation of all the modules, we recommend using the meta package instead.

For the modules that handle stock, please take a look at the MSI module or the Catalog Inventory module depending on your Magento configuration.

Support

You can create issues on our repository. If you need any additional help or support, please contact [email protected]

We are also available on our Magento Slack channel #multisafepay-payments.
Feel free to start a conversation or provide suggestions as to how we can refine our Magento 2 plugin.

A gift for your contribution

We look forward to receiving your input. Have you seen an opportunity to change things for better? We would like to invite you to create a pull request on GitHub.
Are you missing something and would like us to fix it? Suggest an improvement by sending us an email or by creating an issue.

What will you get in return? A brand new designed MultiSafepay t-shirt which will make you part of the team!

License

Open Software License (OSL 3.0)

Want to be part of the team?

Are you a developer interested in working at MultiSafepay? View our job openings and feel free to get in touch with us.

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog,
and this project adheres to Semantic Versioning.

[3.0.1] - 2026-05-18

Fixed

• PLGMAG2V2-906: Fixed an issue where a 'Temporarily Unavailable' message would be shown after being idle in the checkout for a while, due to the API token expiring and not being refreshed

[3.0.0] - 2026-03-17

Added

• PLGMAG2V2-888: Added logic to retrieve orders via redirect tokens (instead of via direct order/session access) for payment redirects, with supporting Javascript refactoring for all payment methods.

[2.14.0] - 2026-02-18

Added

• DAVAMS-913: Added several EAA improvements

[2.13.0] - 2026-01-21

Added

• PLGMAG2V2-871: Added changes that enable Google Analytics cross browser/device tracking

Fixed

• PLGMAG2V2-882: Fixed an issue where an old cart overwrites new cart items when an order was previously placed but not finished

Changed

• PLGMAG2V2-880: Improved the logs for the 'cancel' & 'success' controllers

Removed

• PLGMAG2V2-810: Deprecated the Sofort payment method

[2.12.0] - 2025-09-12

Changed

• PLGMAG2V2-867: Improved when to save the quote on the Cancel controller, it will now save if the payment actually has any additional information that needs to be removed

Removed

• DAVAMS-918: Deprecated Zinia payment method

[2.11.1] - 2025-08-22

Fixed

• PLGMAG2V2-855: Fixed an issue with restoring the cart when using the browser back button on the payment page for Amasty Checkout (Pro) (Now also fixed in Magento version 2.3.7)

[2.11.0] - 2025-07-29

Added

• PLGMAG2V2-852: Added support for Bancontact WIP in Magento Vault
• PLGMAG2V2-859: Added CODE_OF_CONDUCT.md

Fixed

• PLGMAG2V2-860: Fixed an issue where some orders do not have correct values after invoice creation with a specific Amasty Checkout Pro configuration

[2.10.0] - 2025-07-09

Added

• PLGMAG2V2-856: Added logging for payment component requests

Fixed

• PLGMAG2V2-855: Fixed an issue with restoring the cart when using the browser back button on the payment page for third party checkouts like Amasty Checkout (Pro)

[2.9.0] - 2025-05-20

Removed

• DAVAMS-901: Removed the deprecated payment method 'Alipay'

[2.8.2] - 2025-04-02

Fixed

• HYVA-31: Fixed Cart Alive Issue in Hyvä Checkout

[2.8.1] - 2025-02-24

Changed

• PLGMAG2V2-829: Enable Sofort and Dotpay payment methods
• PLGMAG2V2-815: Add delay for cancel controller to wait for order to cancel

Removed

• DAVAMS-840: Remove gender requirement for in3

[2.8.0] - 2024-01-09

Added

• DAVAMS-852: Added the Billink payment method
• DAVAMS-817: Added the Bizum payment method
• PLGMAG2V2-814: Added a payment method instructions field

Removed

• PLGMAG2V2-810: Removed the following deprecated methods: Santander, Giropay, Sofort, Request to pay and Dotpay

[2.7.1] - 2024-09-20

Changed

• DAVAMS-795: Rebrand the logo's, titles and labels from AfterPay to Riverty

[2.7.0] - 2024-08-30

Added

• PLGMAG2V2-779: Added payment component for BNPL methods

Changed

• PLGMAG2V2-785: Upgraded payment icon for MultiSafepay method

Removed

• PLGMAG2V2-784: Removed issuers from iDEAL
• PLGMAG2V2-706: Removed payment component Onload console.log

[2.6.2] - 2024-08-06

Fixed

PLGMAG2V2-780: Fixed an issue where Store Credit would be returned twice

Changed

• PLGMAG2V2-778: Coupons will now be canceled through the OrderService on order cancelation and will happen either through the Notification webhook request or when restoring the cart, depending on the type of transaction

[2.6.1] - 2024-07-05

Changed

PLGMAG2V2-757: Remove payment additionalData when the quote has been restored
PLGMAG2V2-767: Google Pay Direct AbortError is not being displayed on screen anymore when user closes the Payment Request dialog

[2.6.0] - 2024-05-15

Added

• DAVAMS-764: Add in3 B2B

[2.5.1] - 2024-05-01

Fixed

• PLGMAG2V2-752: Fixed Payment Component Temporarily Not Available message after token expiry

[2.5.0] - 2024-04-02

Added

• PLGMAG2V2-731: Added VVV Cadeaubon gateway
• DAVAMS-733: Added Pay After Delivery (BNPL_MF) gateway
• PLGMAG2V2-736: Added browser info to the transaction
• DAVAMS-745: Fixed template id and added merge value for payment component

Fixed

• PLGMAG2V2-733: Make strings translatable

[2.4.0] - 2024-02-16

Added

• DAVAMS-716: Add Multibanco payment method
• DAVAMS-724: Add MB WAY payment method

Fixed

• PLGMAG2V2-727: Fix payment component sometimes not loading

[2.3.2] - 2024-01-24

Changed

• PLGMAG2V2-718: Remove gateway codes from Edenred title
• PLGMAG2V2-716: Refresh API Token and component after expiry
• PLGMAG2V2-720: Only set order canceled on notification controller

[2.3.1] - 2023-12-28

Changed

• DAVAMS-700: Refactored in3 Direct to only make gender mandatory

Removed

• DAVAMS-708: Removed Santander Betaal Per Maand

[2.3.0] - 2023-11-30

Fixed

• PLGMAG2V2-688: Fixed an issue where coupons would not be restored if the payment was canceled/declined

Added

• DAVAMS-596: Added a setting to choose SVG icons instead PNG
• DAVAMS-531: Added an advanced setting for adding a template ID to be used for payment components

[2.2.0] - 2023-10-11

Added

• DAVAMS-661: Added the Zinia payment method

Changed

• DAVAMS-643: Refactored and improved the processing of payment component recurring tokens

[2.1.2] - 2023-09-04

Added

• PLGMAG2V2-681: Added translations for title and placeholder HTML attributes

[2.1.1] - 2023-07-17

Fixed

• PLGMAG2V2-682: Fixed an issue where Google Pay and Apple Pay were not redirecting to the payment page

Removed

• PLGMAG2V2-669: Removed the setup_version from the module.xml

[2.1.0] - 2023-05-17

Added

• PLGMAG2V2-661: Add payment component for Pay After Delivery installments
• PLGMAG2V2-667: Add a setting field to exclude utm_nooverride from the redirect_url

Changed

• PLGMAG2V2-632: Refactor Credit Card Payment Components

Fixed

• PLGMAG2V2-665: Fixed Riverty and in3 component rendering, failing in some third party checkouts

[2.0.0] - 2023-04-03

Removed

• PLGMAG2V2-617: Refactored notification webhook process. Notification webhooks are now processed in the core module and not in the frontend module.

[1.19.0] - 2023-03-07

Added

• Added Pay After Delivery installments payment method

Removed

• Copyright mention has been removed from the files and is only mentioned from now on in the disclaimer. Please read it if you haven't already

[1.18.2] - 2022-12-07

Changed

• Improved the POST notification process by validating the request, before retrieving the order
• Improved the error message that is shown to the customer whenever the payment fails.
• Checking for recurring tokens will only occur now when Magento Vault is enabled.

[1.18.1] - 2022-10-24

Fixed

• Fixed references related to the E-Invoicing configurable 'account_number' field

[1.18.0] - 2022-10-04

Added

• Added Amazon Pay.
• Added an option for E-invoicing to assign collecting flow ids to specific customer groups.
• Added an option for E-invoicing to turn on and off certain checkout fields.

[1.17.0] - 2022-08-23

Added

• Added support for keeping the cart alive when using FireCheckout (Thanks to @mlaurense)
• Added the MyBank payment method
• Improved logging for failed POST notifications

Fixed

• Prevented double execution of order transaction processing when the POST notification fails

[1.16.1] - 2022-07-11

Changed

• Added logging for the notification webhook response

[1.16.0] - 2022-06-29

Added

• Added Vault for Maestro
• Added Tokenization (embedded) for the following gateways:
  • American Express
  • Credit Card
  • Maestro
  • Mastercard
  • Visa
• Added the Alipay+ payment method

[1.15.1] - 2022-05-13

Fixed

• Fixed an issue with the timing of request timeouts for incoming notifications

[1.15.0] - 2022-04-28

Fixed

• Fixed the alignment of the CCV field inside the Credit Card Payment Component

Changed

• Removed checkout references for ING Home'Pay

[1.14.1] - 2022-02-22

Fixed

• Fix notification process for sequential offline actions

[1.14.0] - 2022-01-11

Added

• Added checker if order is actually processing before returning 'ok' for notification requests
• Added options for selecting separate behaviours of cancelling MutliSafepay order payment link

Fixed

• Fixed an issue where sometimes no error message shown with declined AfterPay transaction

[1.13.0] - 2021-11-30

Fixed

• Fixed an issue where frontend fetches API tokens for CC component, while payment type is configured as redirect (Thanks to @thlassche)

Changed

• Changed the Google Pay button background to be transparent instead of white.
• Made changes in the way the payment link is retrieved from the order.
• Extended direct ApplePay with requiredBillingContactFields

[1.12.1] - 2021-11-03

Fixed

• Fixed an issue with AfterPay Date of Birth date picker field

[1.12.0] - 2021-10-29

Added

• Added iDEAL and Direct Debit Vault
• Added Edenred

Changed

• Changed the Vault 'Save for later use' checkbox to be default unchecked instead of checked for MultiSafepay payment methods
• Changed the module to not only return an 'ng' on notification failure and show more information about why the notification process failed

[1.11.0] - 2021-10-15

Added

• Added Apple Pay Direct
• Added Google Pay Direct/Redirect
• Added WeChat Pay Redirect

Fixed

• Fixed Credit Card Payment Component not showing on IE due to new JS syntax (thanks to @thlassche)
• Fixed the utm_nooverride parameter not being picked up in Google Analytics because of a trailing slash (Thanks to @peterjaap)

Changed

• Changed the placement of the iDEAL issuers dropdown to be on top of the billing address instead of below it.

[1.10.2] - 2021-10-07

Changed

• Updated the MultiSafepay credit card component javascript library from V1 to V2.

[1.10.1] - 2021-09-07

Fixed

• Fixed an issue where there were duplicate controllers with the legacy plugin, causing an error on transaction placement.

[1.10.0] - 2021-08-27

Changed

• We are now removing sensitive data from the payment after the customer has been redirected.
• Added date picker field for Date of Birth checkout fields to further increase the consistency of input
• Dropped support for Magento 2.2.x versions.

Fixed

• Fixed a bug where some POST notification can be restricted because of CSRF validation.
• Fixed a bug where retrieving Vault stored cards would cause a type error.
• Fixed PHP Mess detector issues.

[1.9.2] - 2021-07-30

Fixed

• Fixed a bug where some header elements were still visible inside the checkout (Thanks to @Davie82)
• Fixed a bug where the MultiSafepay payment component external js file could not be loaded when using Magento javascript minification

[1.9.1] - 2021-06-25

Fixed

• Fixed a bug related to GET notifications where orders would stay in pending_payment status
• Removed trailing comma for compatibility with IE11 in frontend plugin. (Thanks to @barryvdh)

[1.9.0] - 2021-06-17

• Added MultiSafepay Credit Card component support for credit card payment methods.

Changed

• Moved setting pending_payment status from Redirect controller to Gateway Request Builder
• Changed the notification method from 'GET' to 'POST'
• Improved the logging for the notification actions

[1.8.0] - 2021-06-03

Fixed

• Fixed a bug where the checkout would restore the first quote, when trying to create a second order in the same session.

Added

• Added translations to checkout fields. (Thanks to @Davie82)

[1.7.1] - 2021-05-19

Fixed

• Fixed a bug in payment validation transaction type constant scope, changed it from private to public.

Changed

• Changed composer dependencies to fix bug related payment validation transaction type constant scope.

[1.7.0] - 2021-05-12

Added

• Added the possibility to change direct gateways to redirect
• Added separate phone number field for Afterpay & in3, which will already be filled in if the phone number is present in the billing address

[1.6.2] - 2021-04-19

Fixed

• Fixed an issue related to 400 bad request errors with empty fields in the payment additional data.

Changed

• (dev) Orders are now being retrieved with OrderRepositoryInterface instead of OrderInterfaceFactory

[1.6.1] - 2021-04-09

Removed

• Removed order status check and reopening a cancelled order process from the Success controller, since it is already being done by the Notification controller instead.

[1.6.0] - 2021-03-26

Removed

• Removed obsolete emandate field from Direct Debit checkout

Fixed

• Fixed a bug where the wrong processing status was set for the notifications

Changed

• Refactored notification controller and improved logging

[1.5.0] - 2021-03-11

Added

• Added generic gateways and generic giftcards to the checkout dynamically.
• Added the possibility to modify the "Success page" and cancel payment return URLs for PWA storefronts.
• Added support for a customizable pending_payment status when redirecting to the payment page.
• Changed composer dependencies to support Magento 2.2.

Fixed

• Checkout error when creditcard is preselected

Changed

• Refactored the payment components by decreasing the amount of javascript files

[1.4.0] - 2021-02-22

Added

• Added generic gateway feature for the possibility to add a gateway, which you can customize yourself.
  For more information, please see our Magento 2 plugin docs.
• Added Magento 2 Vault support for credit card payment methods. For more information about the Magento 2 Vault feature, please see Magento DevDocs
• Added support for Magento 2 Instant Purchases (Works only for Vault supported payment methods). Please see the guide how to use and configure Magento 2 Instant purchase feature in Magento DevDocs

Changed

• Code refactoring in big parts of the plugin for code improvement, readability and better performance

[1.3.1] - 2021-02-16

Fixed

• Fixed wrong api key being used for MultiSafepay requests with a multi store setup
• Fixed order status sometimes not going to processing after it has been invoiced

[1.3.0] - 2021-01-26

Added

• Added function to restore quote when using back button on the MultiSafepay payment page
• Added icons for Winkel Cheque, Wellness gift card and Givacard

Fixed

• Fixed bug "Uncaught TypeError: Cannot read property 'observe' of undefined"
• Fixed duplicate id's for birthday checkout field for in3 and Afterpay

Changed

• Changed the way checkout fields are observed and default method is selected.
• Updated Trustly logo to new branding standards

Removed

• Removed duplicate check for sending invoice e-mail

[1.2.0] - 2020-12-10

Changed

• Added new iDEAL icon
• Added in3 to checkout
• Added support for preselected default payment method in the checkout

[1.1.0] - 2020-11-11

Added

• Added Good4Fun gift card to the checkout
• Added missing gift card logos

Fixed

• Fixed notification url leading to ReflectionException on some server configurations
• Fixed error message when SecureToken parameters are missing
• Added support for Magento terms and services checkbox agreement
• Added dependencies in module.xml and composer.json
• Removed setup_version from module
• For some billing suite methods, an automatic invoice will not be sent anymore

Changed

• Rebrand Klarna to the latest standards

[1.0.0] - 2020-09-02

Added

• First public release