This guide explains the required steps in order to successfully set up MultiSafepay as the payment provider in osCommerce. It assumes that you already have a working installation of osCommerce.

Before continuing you may want to review our Getting Started guide.



We recommend uninstalling any previous versions of the MultiSafepay modules for osCommerce before installing a newer version.

Unzip and upload the plugin contents to the root directory of your osCommerce installation.


If this is the first time installing the MultiSafepay plugin for osCommerce you will need to configure the order statuses

  1. Navigate to Localization -> Order Status
  2. Configure the following statuses


There are three different ways to configure the MultiSafepay plugin for VirtueMart 1. 

  1. Basic
    Using the basic configuration MultiSafepay will be shown in the payment menu within VirtueMart 1. The customer can select their preferred payment method on the next screen.
  2. Separate gateways
    Under the separate gateways configuration customers select their preferred payment method directly on the VirtueMart 1 payment menu. This creates a simpler and faster payment process than the Basic method.
  3. FastCheckout
    FastCheckout can be configured as the only payment option available or as an alternative to Connect.

1. Basic

  1. Navigate to Modules -> Payment
  2. Click on Install Module
  3. After the module has installed click on Edit
  4. Enter the following settings

    Enable MultiSafepay payments for this siteEnable

    Account Type

    Select Yes while configuring and validating your plugin setup

    Account ID

    Your MultiSafepay account ID

    Site ID

    The MultiSafepay Site ID for this website

    Site Secure Code

    The MultiSafepay Site Secure Code for this website

    Auto Redirect

    Select True to automatically send customers back to your web shop after a successful payment. Select False to send customers to the MultiSafepay payment success page

2. Separate gateways

  1. Complete the steps above for a Basic installation but at step 4 Disable the Enable MultiSafepay payments for this site option
  2. For each payment method that you would like to offer

    1. Click on Install Module

    2. After the module has installed click on Edit and configure the module

    3. Save your changes.

3. FastCheckout

  1. Select and install the module MultiSafepay - FastCheckout
  2. Enter the same settings as a Basic configuration above


We recommend verifying the functionality once the plugin has been installed and configured. 

Verify Plugin Installation



To provide additional fee customization we have included an additional third party plug-in with the MutliSafepay payment module. This additional customization is only available under the Separate Gateways configuration.

  1. Navigate to Modules -> Order Total
  2. Click on Install Module
  3. Select The cost of payment methods and click on Install Module
  4. After the module has installed click on Edit
  5. Enter the following settings

    Display FeeSelect true to display the fee amount to the customer separately
    Sort OrderDisplay order of the fee
    Fee for payment typeFee amount per payment type
    Fees can be a fix amount or a percentage of the transaction amount  Fee codes are shown below
    TaxThe tax class to use for the fee

    Fee codes

    Bank transfermultisafepay_banktrans
    Direct Debitmultisafepay_dirdebit
    Pay After Deliverymultisafepay_payafter  

    Assign a €2.50 fee to Pay After Delivery and a 2% fee to Visa