SolutionsSystem status
Create accountContact

OpenCart 4

Technical manual for MultiSafepay's free plugin.

Suggest Edits

ℹ

More information

For more information about the plugin and a preview, see OpenCart 4 – MultiSafepay .

Prerequisites

Installation

✅   Tip! We recommend first installing the plugin in a test environment, following the OpenCart 4 installation procedure. Always make a backup.

  1. Download the plugin file: multisafepay.ocmod.zip.
  2. Sign in to your OpenCart 4 backend.
  3. Go to Extensions > Installer.
  4. Click on the Upload icon, and then select the downloaded file.
  5. Click on the Install icon of MultiSafepay in the list of installed extensions.
  6. Once installed, click on the Extensions option in the main menu.
  7. Select Extensions and then Payments inside the Choose the extension type.
  8. In the deployed list of Payments below, find MultiSafepay, and then click on the Install icon.

Additional installation steps

You need to make two specific extra actions in the OpenCart 4 Backend ...

  1. Enable Telephone Display and Telephone Required at System > Settings > Edit your Store > Option > Account

  2. Enable the option Lax in Session Same-Site Cookie at System > Settings > Edit your Store > Server

Configuration

  1. Sign in to your OpenCart 4 backend.
  2. Go to Extensions > Extensions > Payments > MultiSafepay > Edit Icon.
  3. On the MultiSafepay configuration page, configure the:
    • Payment methods tab
    • Order status tab
    • Options tab

To retrieve your API key, see Site ID, API key, and security code.

User guide

Generic gateways

The plugin supports generic gateways, which allows you to add a payment method manually. This is particularly useful for integrating gift cards specific to your business.

How to configure generic gateways

To configure generic gateways, follow these steps:

  1. Sign in to your OpenCart 4 backend.
  2. Go to Extensions > Extensions > Payments > MultiSafepay > Edit Icon.
  3. On the MultiSafepay configuration page > Payment methods tab.
  4. Set the:
    • Gateway name
    • Gateway code
    • Whether to include the shopping cart in refunds (required for BNPL gateway IDs)

You can filter payment methods by:

  • Geographic zone
  • Currency
  • Minimum total amount
  • Maximum total amount
  • Customer groups

Full and partial refunds (except for BNPL orders), and backend orders are fully supported. You can also set a custom initial order status.

Payment components

The plugin supports payment components, which:

  • Provide a seamless checkout experience to increase conversion.
  • Encrypt customer payment details for secure processing.
  • Shift responsibility for PCI DSS compliance to MultiSafepay.
How to activate payment components

If you're new to accepting card payments, email a request to activate them to [email protected]

  1. Sign in to your OpenCart 4 backend.
  2. Go to Extensions > Extensions > Payments > MultiSafepay > Edit Icon.
  3. Select the Payment methods tab and then expand the method of your choice.
  4. Enable Payment Component and optionally Tokenization.

❗️ Note: Tokenization is available only when Payment Component is activated.

💬 Support: If you have a custom checkout and encounter a conflict with the payment component, the Integration Team will do their best to provide support, but we can't guarantee compatibility in all cases.

Payment methods

Supported payment methods

Refunds

Full refunds are supported in your MultiSafepay dashboard and backend.
You can't refund more than the original amount in your backend.

How to process backend refunds
  1. Sign in to your OpenCart 4 <glossary:backend>.
  2. Go to Orders > Order view button > Order history panel.
  3. Click the Refund button.
    This only appears if the order status is Completed or Shipped.

Shopping carts

If you notice any errors in shopping cart calculations, email [email protected]

As a temporary solution, you can disable payments with shopping carts.

How to disable shopping carts

❗️ Note: This disables all BNPL methods.

  1. Sign in to your OpenCart 4 <glossary:backend>.
  2. Go to Extensions > Extensions > Payments > MultiSafepay > Edit Icon.
  3. In the MultiSafepay extension, go to the Options tab.
  4. From the Disable Shopping Cart list, select Yes.
  5. Click Save.

Surcharges

Surcharges are not supported by default.

Applying surcharges with third-party extensions

To apply a surcharge or payment fee to a payment method, you can use the third-party extensions .

The Integration Team will do their best to support you with installing surcharges module, but bear in mind that it is a third-party package. We can't guarantee perfect compatibility.

⚠️

Attention Dutch merchants

We strongly recommend not applying surcharges to BNPL methods. This is now considered providing credit under the Wet op het consumentenkrediet and article 7:57 of the Burgerlijk Wetboek, and requires a permit from the Authority for Financial Markets (AFM).

Updates

  1. Backup all the values you used on the previous installation of MultiSafepay plugin.
  2. Upgrade your store to OpenCart 4.x.
  3. Install MultiSafepay plugin as described before.

💬

Support

Contact MultiSafepay:

Top of page

Updated 3 months ago