---
title: DIBS
slug: commerce-connect-13/docs/dibs-installation-and-configuration
docTags:
createdAt: 2026-07-23T09:44:50.000Z
---
## Install DIBS
Follow these steps to deploy the DIBS payment provider.
### Build a DIBS project
1. [Download the DIBS payment provider file package](https://world.optimizely.com/download2/), which provides an **EPiServer.Business.Commerce.Payment.DIBS** project.
2. Open the **DIBS** project and save the solution.
3. Install the **EPiServer.Commerce.Core**NuGet package by executing this command in Package Manager Console: **Install-Package EPiServer.Commerce.Core**.
:::hint{type="info"}
**Note**
To avoid assembly conflicts, install the Optimizely Commerce Connect Core version that your site is using. Also, apply no database transforms.
:::
:::hint{type="warning"}
**Important**
If you are using Commerce Connect 11 or higher, ignore step 4. That code was removed from Commerce Connect 11.
:::
4. If you are using workflow, uncomment the following line in **DIBSPaymentGateway.cs**:
`payment.Properties["NextAction"] as Action).Invoke();`
5. Rebuild the DIBS project. Now you have the file **EPiServer.Business.Commerce.Payment.DIBS.dll**.
The project package includes these files:
| File | Description |
| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------ |
| *For Commerce Connect versions 10.5 and 11*
DIBSPaymentOption
*For Commerce 12 versions and up*
DIBSPaymentMethod.cs | represents a payment method for DIBS |
| DIBSPaymentGateway.cs | main payment gateway business |
| DIBSPaymentController.cs | the page controller |
| RedirectAndPostActionResult.cs, TransactionRequest.cs | helpers for the controller |
| XML files in lang folder | language files |
| ConfigurePayment.ascx,
EditTab.ascx and its ascx.cs, ascx.designer.cs | Commerce Manager payment editor |
| PaymentMethod.ascx and its ascx.cs, ascx.designer.cs | front-end webform view |
| *For Commerce versions 10.5 and 11*
\_DIBSPaymentMethod.cshtml,
\_DIBSConfirmation.cshtml
*For Commerce 12 versions and up*
\_DIBS.cshtml,
\_DIBSConfirmation.cshtml | front-end mvc view |
| DIBSConfiguration.cs,
DIBSCurrencies.cs,
DIBSLanguages.cs,
DIBSRequestHelper.cs,
Utilities.cs | helper classes |
| DIBSPage.cs | page type |
| DIBS-logo.jpg | logo, in the images folder |
### Commerce Manager
1. Find the Commerce Manager Apps folder, located under the Optimizely Commerce Manager project folder.
2. Deploy the **ConfigurePayment.ascx** file *\_to the \_Apps\Order\Payments\Plugins\DIBS* folder. Create the DIBS folder if it does not exist.
3. Deploy the **EditTab.ascx** file to the *Apps\Order\Payments\MetaData\DIBS* folder. Create the DIBS folder if it does not exist.
4. Deploy **EPiServer.Business.Commerce.Payment.DIBS.dll** to your Commerce Manager site's bin folder.
### Front-end site Webform (Sample site)
1. Deploy **PaymentMethod.ascx** to the website's *Templates\Sample\Units\CartCheckout\DIBS* folder.
2. Deploy **DIBS-logo.jpg** to the website's *styles\images* folder.
3. Deploy the all files in lang folder to the Commerce Connect Sample site's lang folder.
4. Deploy *EPiServer.Business.Commerce.Payment.DIBS.dll* to the Commerce Connect Sample Site's bin folder.
### Front-end site MVC (Quicksilver)
1. Deploy **DIBS-logo.jpg** to your website's styles\images folder.
2. Deploy all files in *\lang* folder to the Quicksilver site's *\lang* folder.
3. Deploy *EPiServer.Business.Commerce.Payment.DIBS.dll* to your Quicksilver site's bin folder.
4. Deploy **\_DIBSConfirmation.cshtml** and **\_DIBS.cshtml** to your website's *Views\Shared* folder.
**(Optional)** The following steps allow the creation of a DIBS under the Checkout page.
1. In your solution's front-end site project, add references to the deployed .dll's
2. Open **CheckoutPage** page type in *Features/Checkout/Pages*.
3. Add **DIBSPage** type to the **AvailableContentTypes** attribute.
```javascript
[AvailableContentTypes(Include = new [] { typeof(OrderConfirmationPage), typeof(MultiShipmentPage), typeof(DIBSPage) }, IncludeOn = new [] {typeof(StartPage)})]
```
4. Rebuild the Quicksilver project.
## Configure DIBS
### Set up the DIBS payment provider in Commerce Manager
After deploying all necessary files, follow these steps.
1. Open the Optimizely Commerce Manager back-end site
2. Go to **Administration > Order System > Payments > English (United States)**. The last option is the language in which you want to make the PayPal payment available.
3. Select **Create new payment method**.
- For **System keyword**, select **DIBS**, the folder name created during deployment.
- For **Class Name**, select **EPiServer.Business.Commerce.Payment.DIBS.DIBSPaymentGateway**.
- For **Payment Class**, select **Mediachase.Commerce.Orders.OtherPayment**.
4. Click **OK** to save DIBS payment method.
5. Open the **DIBS** payment method for editing.
6. Click the **Parameters** tab and enter the following:
- **API UserId** – The user for the DIBS administration page.
- **Merchant Password** – You need only the API UserId to let customers view. But to be able to complete and return an order, you also must add a valid Merchant Password.
- **Processing Url** – The URL to process a DIBS payment, usually `https://payment.architrade.com/paymentweb/start.action`.
- **HMAC key** – Use HMAC key to secure data sent between your system and DIBS.
The key values are available from the DIBS Administration interface *(Integration > HMAC key > K value):*
7. Click the **Markets** tab and add the expected markets for this payment.
### Configure DIBS payment provider in front-end site
To set up a DIBS payment provider, browse to the front-end site and follow these steps.
1. Go to **CMS > Admin >** **Content Type** tab.
2. Add two properties, **DIBSPaymentPage**and **DIBSPaymentLandingPage** of the type **Page**, to the Start page (or Home page) page type.
3. Go to **CMS > Edit.**
4. Create a Page using DIBS Payment Page under the Checkout page, then publish it.
5. Open the site's home page, click the **Site Structure** tab, and define two new properties.
- Set **DIBSPaymentPage** property to the DIBS page that was just created.
- Set **DIBSPaymentLandingPage** property to the Order confirmation page.
### DIBS user experience
After you deploy the files and configure the DIBS payment module on your Optimizely Commerce Connect website, a DIBS option should appear on your checkout page. This section explains how a user interacts with DIBS.
1. During checkout, on the checkout page, select **DIBS** as the payment method.
2. When you click **Place order**, you are redirected to DIBS to verify the payment.
3. When you finalize the approval process, you are redirected to the **Order confirmation** page (previously configured).
