Zen Cart

DIBS has created a plug-in-module for Zen Cart 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 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.

Download module

 


Contact us on Github
Join our community

Guide

DIBS has created a plug-in-module for Zen Cart 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 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.

Module last updated2014-01-30
Module tested on Zen Cart versions1.3, 1.5
DIBS module names and versionsDIBS PW: 4.1.1
Changelog DIBS Payment Window

4.1.1:

- Added language file to translate

Changelog DIBS Flexwin 

 

Features

Module

Admin

Comments

Authorization

NA

No

 

Capture

NA

Yes

 

Instant capture

NA

No

 

Refund

NA

Yes

 

Ticket

No

No

 

Multi refund

NA

Yes

 

Multi capture

NA

Yes

 

Part capture

NA

Yes

 

Part refund

NA

Yes

 

 

 

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.

Step 1

Unpack the module package

Step 2

Upload with FTP (or any other convenient to you way) the directories ext, images and includes to root directory of your ZenCart installation.

Note: Please, recheck the owner and permissions of the newly uploaded files. If you don't know how to do that or what the right values are for the parameters, please contact your system administrator or developer.

Step 3

Go to your site in a browser and log in as administrator

Step 4

Go to "Modules" -> "Payment" in the top menu

Step 5

Click the name of the module in the appeared modules list

Step 6

Click the "install" button on the right column

NOTE: Module name on the picture can differ from the name of your module

Step 1

Go to your site in a browser and log in as administrator

Step 2

Go to "Modules" -> "Payment" in the top menu

Step 3

Click the name of the module in the appeared modules list

Step 4

Insert the MerchantID, currency ect.

Step 5

If you want to do test transactions, activate test mode

Step 6

Click "update" when done

If you're installing the FlexWin module, you can find the following files in your package:

  • orders.php – updated orders.php file with integrated buttons support.
  • orders.php.patch – patch to update original file with diff tool.
  • orders_original.php – original orders.php that we used to integrate buttons.

 

You can add API buttons support in following ways:

  • If your %admin_directory%/orders.php is the same as orders_original.php from module package – just replace your file with ours.
  • If your %admin_directory%/orders.php is not the same as orders_original.php from module package – try to apply patch orders.php.patch from module package or to add changes manually.

Note: Here %admin_directory% is the name you gave to the administrator directory after the ZenCart installation.

Note: Please, backup your original order.php file, before replacing it or making any 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.

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!

DIBS Payment Window

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 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

Contact us!
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: support@dibs.dk

Or get in contact with us through https://github.com/DIBS-Payment-Services/.
We are happy to get your input and help.
 

Support
In case you need help from our support you can mail: support@dibs.dk 
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!
Best Regards,
DIBS Opensource team

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