Wordpress Ecommerce

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

In order to go live with your webshop you will also need an agreement with an acquirer, who takes care of collecting and depositing your money. DIBS has partnered with a number of acquirers who offer a wide variety of options and we will provide the help and guidance you need in order to get started.

You are welcome to sign up for a free demo account http://www.dibspayment.com/demo-signup allowing you to prepare your technical deployment and performing test payments using our test card data.

Download module

 

 


Contact us on Github
Join our community

Guide

Module last updated 2015-04-01

Module tested on Wordpress Ecommerce versions

3.8, 3.8.8, 3.8.10, 3.8.11, 3.8.12.1, 3.9.1

Wordpress version used in tests

4.1

DIBS module names and versions DIBS PW and Mobile: 4.1.8
Flexwin 3.0.2
Technical requirements

DIBS PW and Mobile & Flexwin:
PHP extension: mbstring
Technical requirements Flexwin:    
PHP extension: curl
(In further versions of FlexWin modules the fallback mode will be added: use of fsockopen when curl is unavailable)

Changelog DIBS Payment Window

4.1.8

-Added support for DX platform

4.1.7:

-Added possibility to add DIBS checkout logos in Admin

4.1.6:

-Complete code rewrite and refactoring

-Fixed notices with database

-Developed according to WordPress standards

4.1.5:

- Added partnerId parameter

4.1.4:

- Added discount coupons to amount calculation

4.1.3:
- Fixed bug with PENDING status in callback

4.1.2:
- Fixed problems with installation
- Removed mobile payment window (we don't support it any more)
- New Readme guide has been created

Changelog DIBS Flexwin

3.0.2:

Added FlexWin decorator responsive, bugfixing.

 

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

 

 

 

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 (DIBS Payment Window)

Click on “Integration” and “HMAC key”. Mark “Perform HMAC checksum control” and click “Update”. The HMAC key is to be used later on in the process.

Activate MD5 control (DIBS Flexwin)

Click on “Integration” and “MD5 keys”. Mark “Perform MD5 control.” And click “Update”. The MD5 Key is to be used later on in the process.

Use this guide for configuring DIBS' system if you have an account on the DX platform.

Activate your HMAC Key

Click on “Integration”. Mark “HMAC authentication enabled” and click “Save”. The HMAC key is to be used later on in the process.

Admin 2.0 HMAC Key placement

 

Step 1

Unpack the module package

Step 2

Upload with FTP (or any other way that is convenient for you) the directory "dibs_api" and "dibspw.php" to path like the following example.

%myWordpress%/wp-content/plugins/wp-e-commerce/wpsc-merchants

NOTE: Change %myWordpress% in example to real path to your Wordpress installation root

NOTE: Please, recheck the owner and permissions of the newly uploaded files. If you don't know how to do that or what is right values for that parameter, 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 "Settings" -> "Store"

Step 5

Go to "Payments" tab on opened page

Step 6

Check the "checkbox" near the DIBS module name and click on the "Save Changes" button to enable the module

Step 1

Go to your site in a browser and login as administrator

Step 2

Go to "Settings" -> "Store"

Step 3

Go to "Payments" tab on the opened page

Step 4

Click on the "Settings" link under module name to configure the module

Step 5

Fill out the module settings and click on the "Update" button to save

Step 6

You need to click on the "Update" button under "Module Settings" under the "billing form" to save information

Step 7

To use the module in test mode, you have to set the test parameter to "Yes"

NOTE: Please pay attention when you're filling in address associations. Wordpress has both delivery and billing fields in the same select boxes, thus it's easy to confuse its associations.

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

 

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

Please sign up for technical updates

- no sales buzz here!

Check your interests :

Do you have 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