1. Introduction

DIBS has created a plug-in-module for Magento that offers you a smoother integration.

Before starting to use our module we recommend you to contact our sales department. By doing so, you can ensure that you get the right payment methods, currencies, and know which of our payment windows that best suits your business.

In order to go live with your payments you will also need a part that collects and deposit your money. This part is called acquirer. For the most common payment types, VISA and MasterCard, we are happy to offer DIBS Account which can be used instead of an acquirer. For other payment types, DIBS has partnered with a number of acquirers who offer a wide variety of options.

Our sales departments will also help you to get a DIBS ID for testing, which is needed to integrate the module. With the “test account” you can complete the integration and make test transactions with our test cards.

2. Information about the module

 

Module last updated

2013-08-27

Module tested on Magentoversions:

1.5 - 1.5.1, 1.6 - 1.6.2, 1.7 - 1.7.0.2

(The module might work on other versions but is   not tested. The same goes for Magento extentions, it might work but it’s not   tested).

DIBS modulenames and versions:

DIBS PW and Mobile: 4.2.6

Flexwin 3.1.0

Changelog DPW 4.2.1 – 4.2.2

4.2.2 – 4.2.3

Buggfix - correction on how to round of the   total amount

Added online capture, refund and cancel   functions.

4.2.3 – 4.2.4Bugfix release. Bug in config xml
4.2.5

Bugfix release. Fixed problem with online

cancel on some versions of Magento

4.2.6Small improvements and bugfixing

 

3. How to configure DIBS Payment system for the module

DIBS Payment Window

Return values

Start by loging in to DIBS Administration system. Click on “Integration” and “return values”. Then check all boxes as bellow and click on “save settings”.

Make sure that all return values are activated and save the settings.

Activate your HMAC Key

Click on “Integration” and “HMAC key”. Then mark and perform HMAC Checksum control and click on “update”. The HMAC key is to be used later on in the process.

                  

Flexwin

Return values

Start by loging in to DIBS Administration system. Click on “Integration” and “return values”. Then check all boxes as bellow and click on “save settings”.

Make sure that all return values are activated and save the settings.

Activate MD5 control

Click on “Integration” and “MD5 keys”. Then mark and perform MD5 control and click on “update”. The MD5 Key is to be used later on in the process.

4. Install DIBS payment module

Step 1

Sign in as Administrator. http://yoursite.com/admin

 

Step 2

Go to the Magento Connect ? Magento Connect Manager in System menu:  

Step 3

Sign in as Administrator in the opened page.

Step 4

Here you can install module in 2 ways (for your choice):

4.1

Either with Magento Connect Extension Key:

           

4.2

Or by choosing and uploading tgz package (e.g: module_name.tgz) from your computer:  

             

Step 5

After successful installation you will see appropriate notice and your module will appear in the list below the installation forms.

           

5. Configure DIBS payment module

Step 1

Sign in as Administrator. http://yoursite.com/admin

Step 2

Go to the Configuration page using System menu:  

                 

Step 3

Click on the “Payment methods link” below the Sales section in left menu:

                

Step 4

Click on the DIBS module you want to configure to expand its configuration form (if it's collapsed):
                  

Step 5

Edit settings and click on “Save config button” to save new settings:

                

Step 6

Now you can try test transaction.

6. Before you go live

We recommend performing test transactions before your shop goes Live. In our 10-step guide you will find test cards for your own tests. When you see that it works with the test cards, you can remove the “test-parameter” and perform transactions with real cards. We would also like to recommend you to test transactions with the different currencies that you want to be activated.

When this works, and you can track the payments in DIBS Administration, the technical integration is done.

On our techsite you will also find logos and more information about what your site needs to show in order to follow rules and regulations from your acquiring partner.

When you have been through the steps above you will be set to go Live!

7. Common errors

DIBS Payment Window

Problem: HMAC code not matching

This issue may arise when using the DIBS Payment Window module.

Solution:

Go to: System -> Configuration -> Web -> Session Validation Settings

And set 'Use SID on Frontend' to 'No':

Problem: Calling DIBS Payment Window throws error “A technical error has  occurred”

Solution:

There can be various reasons and solutions to this message:


A: Your agreement with DIBS is not yet in a live state, but the test mode setting in the module is set to false/no. Your agreement will be set live when you have signed an acquirer agreement and a site inspection has been made by DIBS in your webshop. We will notify you in writing when the acquirer agreement has been tested. 
For more information regarding the site inspection and steps needed before your agreement is put in live mode, please see the following steps 
http://tech.dibs.dk/10_step_guide/site_inspection/
http://tech.dibs.dk/10_step_guide/go_ahead/

B: Your agreement with DIBS is put in live mode, but the test mode setting is still activated in the module.  If you have received confirmation from us that your agreement with DIBS has been set live, the test mode setting in the module must be deactivated in order to carry out live payments.  Check that test mode is set to false/no in the module
The error message will show the following information if test mode is activated in the module, but deactivated in DIBS: 
The following fields had validation errors:
currency - There are no payment types available in test matching that currency

C: Your agreement with DIBS does not support the currency. Check that you have signed an acquirer agreement for the currency. If not, please contact the acquirer to add the currency to your agreement. The acquirer will relay this information to DIBS, but please note that adding currencies might take a few days. 

Please contact DIBS support for additional information regarding the status of your agreement and available currencies.

D: The module is configured with incorrect HMAC value.  The error message will include the following information:  The following fields had validation errors:  MAC - did not match calculated value.


Check that the values of HMAC key  in the module corresponds to the exact same value generated in the DIBS Administration for the Merchant ID you are using. The key is found in the DIBS Admin à Integration à HMAC

Flexwin

Problem: Calling FlexWin returns “No paytype(s)! Missing test parameter?”

 

Solution:

There can be various reasons and solutions to this message:

A: Your agreement with DIBS is not yet in a live state, but the test mode setting in the module is set to false/no. Your agreement will be set live when you have signed an acquirer agreement and a site inspection has been made by DIBS in your webshop. We will notify you in writing when the acquirer agreement has been tested. 
For more information regarding the site inspection and steps needed before your agreement is put in live mode, click here.


B: Your agreement with DIBS is put in live mode, but the test mode setting is still activated in the module. If you have received confirmation from us that your agreement with DIBS has been set live, the test mode setting in the module must be deactivated in order to carry out live payments.  Check that test mode is set to false/no in the module.

C: Your agreement with DIBS does not support the currency. Check that you have signed an acquirer agreement for the currency. If not, please contact the acquirer to add the currency to your agreement. The acquirer will relay this information to DIBS, but please note that adding currencies might take a few days. 

Please contact DIBS support for additional information regarding the status of your agreement and available currencies.

Problem:  Calling FlexWin returns “Md5Key mismatch!” error message.


Solution:

Check that the values of the MD5 key 1 and 2 in the module corresponds to the exact same values generated in the DIBS Administration for the Merchant ID you are using. The keys are found in the DIBS Admin à Integration à MD5 Keys

Problem: Calling FlexWin returns “no md5key!”


Solution:

Check that the values of the MD5 key 1 and 2 in the module corresponds to the exact same values generated in the DIBS Administration for the Merchant ID you are using. The keys are found in the DIBS Admin à Integration à MD5 Keys.

Should you wish to deactivate the MD5 key control (not recommended), you can do so in the DIBS Administration.  The MD5 keys must also be removed from the module settings. Please notice that any spaces in the MD5 key 1 or 2 fields is interpreted as content.

Problem: After the payment has been registered in DIBS, Magento throws “A fatal error has occured” No orderid was returned from DIBS payment gateway

Solution:

This error in Magento is thrown if the return values in the DIBS Administration are not configured. Access your DIBS Administration à Integration à Return values and activate all available values.

Do you have a question or need help?
Follow us
DIBS Payment Services
Stockholm +46 (0)8-527 525 00
Göteborg +46 031-600 800
København +45 7020 3077
Oslo +47 21 55 44 00