VirtueMart 1

This guide explains the required steps in order to successfully set up MultiSafepay as the payment provider in VirtueMart 1. It assumes that you already have a working installation of Joomla and that the VirtueMart 1 plugin has been installed.

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

Installation

Unzip and upload the plugin contents to the root directory of your Joomla installation. This may overwrite some existing files and will add new files to the VirtueMart 1 plugin. These changes are intentional and required.

Configuration

There are two 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.

 

1. Basic Configuration

  1. Navigate to Components -> VirtueMart -> Store

  2. Click on Add Payment Method
  3. Enter the following settings

    ActiveChecked

    Payment method name

    Provide a description to be shown in the payment menu

    Code

    MSP

    Payment class name

    ps_multisafepayfast

    Payment method type

    HTML-Form based (e.g. PayPal)

  4. Click on the Configuration tab

  5. Enter the following settings

    MultiSafepay Account Type

    Connect

    MultiSafepay 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

    Use Test Environment

    No
    Select Yes while configuring and validating your plugin setup

    Show the FastCheckout Button

    No
    Only select Yes if you plan to use the FastCheckout payment method

    Calculate tax over shipping cost

    No Select Yes to include the cost of shipping in your tax calculation

    Default tax

    0.09750

    Send order status update email to customer?

    Select Yes to send update emails to a customer when the status of an order changes

    MultisafePay Initialized Status

    Pending

    MultisafePay Complete Status

    Confirmed

    MultisafePay Uncleared Status

    Pending

    MultisafePay Reserved Status

    Pending

    MultisafePay Void Status

    Cancelled

    MultisafePay Declined Status

    Cancelled

    MultisafePay Reversed Status

    Cancelled

    MultisafePay Refunded Status

    Refunded

    MultisafePay Expired Status

    Cancelled

    MultisafePay Cancelled Status

    Cancelled
  6. Click Save to store the payment module settings

2. Separate Gateways

To configure separate gateways you must add each payment method you wish to provide as separate payment options within your web shop. We recommend adding all the payment methods you wish to offer in your web shop first and afterwards configuring just one of them. The configuration settings will automatically be shared by all of the payment methods.

Repeat these steps for each payment method you wish to add.

  1. Navigate to Components -> VirtueMart -> Store

  2. Click on Add Payment Method
  3. Enter the following settings

    Active

    Checked

    Payment method name

    Provide a description to be shown in the payment menu

    Code

    The code for the payment method you wish to use. See below.

    Payment class name

    ps_multisafepayfast

    Payment method type

    HTML-Form based (e.g. PayPal)

    Payment Codes

    BGIFTBaby Gift Card
    BKTRSBank Transfer
    BKBBoekenbon Gift Card
    DIRDEBDirect Debit
    DBANKDirect Bank
    EBONE-BON Gift Card
    ERBONErotiek Gift Card
    FCFine Gift Card
    DPGiroPay
    MAEMaestro
    MCMaster Card
    MISCAMisterCash
    WALLMultiSafepay Wallet
    PCKPerfume Gift Card
    PNLPerfume NL
    VISAVisa
    WGCWebshop Gift Card
    PAYAFTERPay After Delivery
  4. Save your changes

After all the payment methods have been entered configure one with the settings displayed under Basic Configuration, Step 5 above.

Note: For iDEAL an additional step is required. Enter the following code snipped into the Payment Extra Info field.

<?php
  $amount = $db->f('order_total')*100;
 $orderNumber = $db->f('order_id');
include(JPATH_ROOT.DS.'administrator'.DS.'components'.DS.'com_virtuemart'.DS.'html'.DS.'checkout.processideal.php');
?>

Configuration

  1. Navigate to Configuration for the MultiSafepay payment method
  2. Enter the settings as shown below

    Account Type

    Live
    Choose Test when validating your installation 

    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

    Notification URL

    This is the Notification URL MultiSafepay uses to update the order statuses in the back office of your website.

    Logo for Payment

    An optional logo.

    Initialized

    Pending

    Complete

    Confirmed

    Uncleared

    Pending

    Void

    Cancelled

    Declined

    Cancelled

    Refunded

    Refunded

    Expired

    Cancelled

    Cancelled

    Cancelled

    Currency

    Euro

    Other currencies are supported but you may have to contact us to have these enabled.

    Countries

    Enter any countries which you would like to restrict shipping too

    Minimum amount

    Min. order amount

    Maximum amount

    Max. order amount

    Fee per transaction

    Any set amount additional fees to add to transactions.

    Percentage of the total

    Any proportional additional fees to add to transactions.

    BTW

    VAT

  3. Save your changes

Verification

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

Verify Plugin Installation

 

 


 

Troubleshooting

The FastCheckout button isn't shown in the payment menu

The most common cause of this is a custom payment template. In this case a code snippet will need to inserted into the following files:

  • /components/com_virtuemart/themes/eigentemplate/basket/basket_b2b.html.php
  • /components/com_virtuemart/themes/eigentemplate/basket/basket_b2c.html.php
<?php if(isset($multisafepay_fastcheckout_button)) : ?>
   <tr>
    <td colspan="4" align="right"><?php echo $multisafepay_fastcheckout_button; ?></td>
  </tr>
<?php endif; ?>