OpenCart 3

Technical manual for MultiSafepay's free plugin.

More information

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

Prerequisites

Installation

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

  1. Download the Plugin_OpenCart_3.x.x.ocmod.zip.
  2. Sign in to your OpenCart backend.
  3. Go to Extensions > Installer.
  4. Click the Upload button, and then select the downloaded file.
  5. Once installed, click the Dashboard menu.
  6. To clear both caches, click the blue cog wheel button in the top-right corner, and then click the Refresh icon.
  7. Go to Extensions > Modifications, and then click the Refresh button.
  8. Go to Extensions > Payments > MultiSafepay, and then click the Install button.

Configuration

  1. Sign in to your OpenCart backend and go to Extensions > Extensions > Payments > MultiSafepay.
  2. 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

Checkouts

The plugin supports the OpenCart core checkout and is compatible with most premium themes, unless you have a custom checkout.

Patches for third-party themes and extensions

The table belows shows the patches available for third-party themes and extensions:


The Integration Team will do their best to provide support for third-party plugins and premium themes. Email

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.

Supported since release: 3.9.0, March 19th 2021.

How to configure generic gateways

To configure generic gateways, follow these steps:

  1. Sign in to your OpenCart backend.
  2. Go to Plugin settings > Payment methods tab.
  3. Set the:
    • Gateway identifier
    • Gateway logo
    • Gateway label
    • Whether to include the shopping cart in refunds (required for BNPL gateway IDs)

You can filter payment methods by:

  • Geographic zone
  • Currency
  • Minimum amount
  • Maximum 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 backend.
  2. Go to Extensions > Type: Payments > MultiSafepay > Edit.
  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 links

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 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 backend.
  2. Go to Extensions > Payments > MultiSafepay.
  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 no longer supported, but you can request a patch.
Email [email protected]

⚠️

Attention Dutch merchants

We strongly recommend not applying surcharges to BNPL orders. 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

You can update the plugin using the extension installer tool in your OpenCart backend.

How to update from version 2.2.0 to 3.x.x
  1. For security, always create a backup of your OpenCart application.
  2. Download the Plugin_OpenCart_3.x.x.ocmod.zip.
  3. Sign in to your OpenCart backend.
  4. Go to Extensions > Installer.
  5. Click the Upload button, and then select the downloaded file.
  6. Once installed, in the menu go to Dashboard.
  7. To clear both caches, click the blue cog wheel icon in the top-right corner, and then click the Refresh icon.
  8. Go to Extensions > Modifications, and then click the Refresh icon.
  9. Go to Extensions > Payments > MultiSafepay.
  10. To access the Settings page, click the Edit button.
  11. A warning appears requesting you to delete old plugin files.
  12. In the Maintenance tab, click Delete old plugin files.
How to update from version 2.1.0 or below
  1. For security, create a backup of your OpenCart application.
  2. Manually remove all files from the MultiSafepay extension using an FTP program or server file administration program.
  3. Follow the installation instructions above.


💬

Support

Contact MultiSafepay:

Top of page