Sepa Direct Debit Mandate

Written by Valérie Isaksen on .

Back to store

This tutorial explains how to install and configure the Direct Debit Mandate plugin for VirtueMart2.


Installation of the plugin

  1. Install the Direct Debit Mandate plugin via the Joomla Installer
  2. Enable the plugin via the Joomla Plugin Manager. You can filter the plugins by selecting vmpayment in the Select Type filter.

Before creating a new Payment method

Before creating your payment method, check that the parameter Safe Path is correctly configurated. When your payment is saved, a file containing the encryption key is created and stored in the folder Safe Path/istraxx_ddmndate.

  1. Go in the component VirtueMart, and select the menu Configuration > Configuration
  2. Select the tab Templates
  3. Check that the parameter Safe Path is correct

Create a new Payment method

  1. From the VirtueMart administration, choose the menu Shop > Payment methods
  2. Choose the New button
  3. Enter a payment name. It is title that will appear on your web site.
  4. In the select list Payment method Method, select DD mandate
  5. Click Save

Configure the Direct Debit Mandate Plugin

  1. Click on the Configuration tab to configure your payment method
  2. Creditor Identifier: enter your creditor identifier.


  1. Logos: chose a logo to display along with your payment
  2. Order Status for created orders: select the order status for the created orders
  3. Order Status for account debited: select the order status of the order when the account is debited
  4. Order Status for revoked mandate: select the order status of the order when the mandate is revoked


  1. Countries: if you want to restrict this payment method to one or more specific countries, select them. If no countries are selected, the payment method is available for all countries.
  2. Minimum Amount: enter for which minimum amount this payment method will be displayed. If no amount is entered, the payment is displayed in all cases.
  3. Maximum Amount: enter for which maximum amount this payment method will be displayed. If no amount is entered, the payment is displayed in all cases.


  1. Discount or Fee per Transaction %
  2. Discount or Fee per Total Amount
  3. Tax

Click on Save
When your payment is saved, a file containing the encryption key is created. This file is stored in the folder Safe Path/istraxx_ddmndate 

Test your payment

Do a checkout.

In the page Edit payment, the form for the Debit Mandate is displayed.

The form is prefilled with the client's Bill To address if already given, and has to enter 

  • the bank name
  • the IBAN
  • the BIC
  • Enter his name
  • and sign the mandate with either the mouse or the finger.


Once the payment has been selected, all the informations are displayed in the cart, as well as the legal informations of the payment


On the thank you page, as well as on his account, the client can

  • download the mandate in a PDF format,
  • revoke the mandate via the link
In the order view, all the infos concerning the payment have been save, and the merchant can download the mandate also. 
The mandates are stored under the folder Safe Path/istraxx_ddmndate.

Structure of the Creditor Identifier

The Creditor Identifier is a uniform and standardized identification field used throughout Europe that unambiguously identifies the creditor.

The structure of the Creditor Identifier has been standardized throughout the Single Euro Payments Area (SEPA). It is made up of the respective:

  • ISO country code, 
  • a check digit comprising 2 characters, 
  • the Creditor Business Code and 
  • a country-specific part, called the national identifier, which may vary in length but must not exceed 28 characters. 

The length of the Creditor Identifier therefore differs from country to country. However, it is never any longer than 35 characters.


ISO country codeCheck digitsCreditor Business codeNational identifier
NL 98 ZZZ 999999990000

Bank Identifier Code: BIC

A BIC identifies the bank branch and looks like this MIDLGB22123.

Usefull links

Trouble shooting

- While creating the payment method, a white page is displayed 

You are probably not using the correst VirtueMart version. The minimum version for VirtueMart is 2.6.15

- Some browsers do not store the SEPA mandate

An https connection at least for sensitive areas is mandatory for the SEPA mandate. If you have additional ressources by css, layout override, or additional payment info, then you must ensure to use either relativ links (using https automatically then) or absolute links using https, else some browsers see it as pishing page and prevent storing.

We use cookies on our website. Some of them are essential for the operation of the site, while others help us to improve this site and the user experience (tracking cookies). You can decide for yourself whether you want to allow cookies or not. Please note that if you reject them, you may not be able to use all the functionalities of the site.