osCommerce

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.

 

Installation

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.

Configuration

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

    InitializedInitialized
    CompletedCompleted
    UnclearedUncleared
    ReservedReserved
    VoidedCancelled
    DeclinedDeclined
    ReversedReversed
    RefundedRefunded
    ExpiredExpired

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

    No 
    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

Verification

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

Verify Plugin Installation

 


Optional

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
    Giropaymultisafepay_giropay
    iDEALmultisafepay_ideal
    Maestromultisafepay_maestro
    MasterCardmultisafepay_mastercard
    MisterCashmultisafepay_mistercash
    Pay After Deliverymultisafepay_payafter  
    Visamultisafepay_visa

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

multisafepay_visa:2.50:0,multisafepay_visa:0:0.02