Sana Commerce 9.3
Your connector

Configure DIBS

To configure the DIBS payment provider and payment methods you should have the DIBS test/live account with all the necessary data.

Set up DIBS

Step 1: In Sana Admin click: Apps > Add-ons. When the DIBS add-on is installed, you can configure it from any tab on the "Add-ons" page by clicking on the Configure button .

Step 2: Choose the appropriate payment integration mode.

There are two modes: test and live. Test mode allows to simulate the payment process as if it is a real payment and helps to make sure that everything will behave the same way when you go live. Live mode implies that a customer makes a real purchase using already configured payment provider and methods.

Step 3: Configure the payment provider by entering the payment provider specific settings of the test/ live account.

The table below provides the description of the DIBS payment provider fields:

Field Description
Merchant ID Enter the merchant ID of the DIBS account. This ID can be found in the DIBS admin panel.
Default value: depends on the account (test/ live)
MD5 key1 Enter the keys that are used to calculate the MD5 checksum. The values for these keys can be generated in the DIBS admin panel.
Default value: depends on the account (test/ live)
MD5 key2
Enabled payment types Enter the payment types that should be enabled for DIBS payments. Use the "," character to separate several payment types. There should be no spaces between payment types.

The list of the available DIBS payment types can be found in the official DIBS documentation. For more information, see "Paytypes".
Default value: <empty>
Capture immediately This setting controls whether the payments are captured immediately when the user completes the payment authorization. If this setting is set to "true", then the funds will be transferred from the customer's account immediately. If this setting is set to "false", then all payments have to be captured manually from the DIBS administration.
Default value: true
  • If Capture immediately  is set to "true", then the payments should never be captured manually.
  • If Capture immediately  is set to "false", then the payments must be captured manually. Sana Commerce does not provide a process to automate this.
Use Transaction ID If this option is enabled, then the Sana transaction ID will be mapped to the order number in the payments in DIBS Administration. If disabled, the Sana order ID will be mapped to the order number in the payments in DIBS Administration. By default, this option is disabled.

You can change the look and feel of the DIBS payment window by uploading the decorator files in the DIBS admin panel. For more information, see "Styling" on the official DIBS web site.

When customers pay their orders via the DIBS payment gateway, the DIBS accept page is shown to them. Quite often customers close the browser tab when they pay the order and see the accept page rather than waiting for a redirect to the Sana web store. This sends the order confirmation e-mail even if the option "Capture immediately" is disabled. To avoid this, you can log in to the DIBS Administration and go to: Integration > FlexWin. In the FlexWin settings you can enable the option Skip accept page. If it is enabled, customers will be automatically redirected to the Sana web store right after they pay their orders.

When DIBS is configured you can set up the necessary payment methods in Sana Admin that are supported by DIBS.

For information about how to create and configure payment methods in Sana Admin, see "Payment Methods".

Test the payment/checkout flow to see if everything works fine using the created payment methods and the correct payment statuses.

When everything is done and tested, keep an eye on the payment log in the following days to be sure that everything is configured correctly.