DIBS have created a plug-in-module for Virtuemart 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.
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.
DIBS have created a plug-in-module for VirtueMart that will help you to a smother integration.
Before starting to use our module we recommend you to contact our sales department for consultancy. By doing this you make sure that you will get the right payment methods, currencies and know which of our payment windows that best suits your business.
The sales departments will also help you to get a DIBS account or merchant ID, for test which is needed to integrate the module. With the “testaccount” you can complete the integration and make test transactions with our test cards.
|Module last updated||2014-01-30|
|Module tested on Virtuemart versions||2.0, 2.0.2, 2.0.4, 2.0.6, 2.0.16, 2.0.18, 2.0.20, 2.0.22, 2.0.24c|
|DIBS module names and versions||DIBS PW: 4.1.4|
|Changelog DIBS Payment Window|
- Fixed bug with PENDING status in callback
|Changelog DIBS Flexwin|
Activate your HMAC Key
Click on 'Preferences' -> 'Integration'. Click 'Request HMAC key'. Mark 'HMAC authentication enabled' and click “Save changes”. The HMAC key is to be used later on in the process.
Sign in as administraton: http://yoursiteurl.com/administrator/
Go to the "Extensions" -> "Extension Manager" section in administration menu
Choose the package source that is most convenient to you. Choose package to upload or type a path to the package
Click "Install" (Or "Upload & Install" in case of direct upload)
Click "Manage" when the package is installed
To find DIBS plugin you can use filter
set "- Selected status" filter to "Disabled" and "- Select Folder" to "vmpayment"
Click on the red "Status" column to enable module (Status should change color to green)
Sign in as Administrator : http://yoursiteurl.com/administrator/
Go to "Components" -> "VirtueMart" section in administration menu
Click "Payment Methods"
Click "New" to add new payment method
For basic setup fill "Payment Name", set "Published" to "Yes" and select in "Payment Provider" dropdown "DIBS Payment Window" or "Flexwin"
Save the new payment method
When payment method is saved, go to "Configuration" tab to setup plugin
When setup is completed, remember to save changes
We recommend performing test transactions before your shop goes Live. In our toolbox you can find test information, for your own test. When you see that it works with the test cards, you can disable test mode for the payment module 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.
When you have been through the steps above you will be set to go Live!
DIBS Payment Window
Problem: Calling DIBS Payment Window throws error “A technical error has occurred”
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 would like to start receiving live payments and a site inspection has been made by DIBS in your webshop.
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: 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 Administration under 'Preferences' -> 'Integration'.
Help and contact
We want to get in contact with you and learn more of what you want us to focus on and how you think we can improve our modules. Please mail DIBS Opensource team directly on: email@example.com
Or get in contact with us through https://github.com/DIBS-Payment-Services/.
We are happy to get your input and help.
In case you need help from our support you can mail: firstname.lastname@example.org
Or contact our support via telephone - see local numbers below.
For a better and quicker support please include the following details in your mail to us:
- Your Merchant id with DIBS
- Name and version of the opensource module
- Version of the DIBS module you are using
- Other info ex. Do you use any extension to the system that differs from the “default” setup.
Thank you for using our Module!
DIBS Opensource team