--- title: DIBS installation and configuration slug: cms-11/dev-docs/dibs-installation-and-configuration docTags: createdAt: 2026-07-22T19:45:18.000Z --- :::hint{type="info"} **Note** This content is retired and no longer maintained. ::: ## Build a DIBS project 1. Download the DIBS payment provider file package, 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 Customized Commerce Core version that your site is using. Also, apply no database transforms. ::: :::hint{type="warning"} **Important!** If you are using Optimizely Customized Commerce 11 or higher, ignore step 4. That code was removed from Optimizely Customized Commerce 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: - `DIBSPaymentMethod.cs` (Optimizely Customized Commerce versions 12 and up) – represents a payment method for DIBS - `DIBSPaymentOption` (Optimizely Customized Commerce versions 10.5 and 11) – represents a payment method for DIBS - `DIBSPaymentGateway.cs` – mainpayment 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 - `DIBS.cshtml`, `DIBSConfirmation.cshtml` (Optimizely Customized Commerce 12 versions and up) – front-end mvc view - `DIBSPaymentMethod.cshtml`, `DIBSConfirmation.cshtml` (Optimizely Customized Commerce versions 10.5 and 11) – 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 Sample site's lang folder. 4. Deploy `EPiServer.Business.Commerce.Payment.DIBS.dll` to the Commerce 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. `[AvailableContentTypes(Include = new \ { typeof(OrderConfirmationPage), typeof(MultiShipmentPage), typeof(DIBSPage) }, IncludeOn = new \ {typeof(StartPage)})\` 4. Rebuild the Quicksilver project. ## DIBS configuration ### Set up the DIBS payment provider in Commerce Manager After deploying all necessary files, follow these steps. 1. Open the Optimizely Customized 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 name of the folder created during deployment. - For **Class Name**, select **EPiServer.Business.Commerce.Payment.DIBS.DIBSPaymentGateway**. - For **Payment Class**, select **Mediachase.Commerce.Orders.OtherPayment**. ![](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/BPcuyQ2CpsD53-p720fB_-20260722-194642.png) 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: 1. **API UserId** – The user for the DIBS administration page. 2. **Merchant Password** – To let customers view, you need only the API UserId. But to be able to complete and return an order, you also must add a valid Merchant Password. 3. **Processing Url** – The URL to process a DIBS payment, usually `https://payment.architrade.com/paymentweb/start.action`. 4. **HMAC key** – Use HMAC key to secure data sent between your system and DIBS. ![](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/pmFJ8cRLfLiSdHsWY8AHF-20260722-194642.jpg) 5. The key values are available from the DIBS Administration interface `(Integration > HMAC key > K value):` ![](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/fRJFjO_1nIQgY3117H_If-20260722-194642.jpg) 7. Click the **Markets** tab and add the expected markets for this payment. ![](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/pDQF_WKVaZ9t4rpDUtPIO-20260722-194642.png) ### Setup 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. ![](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/aOcR-41KBeWsJ0-vVNK9q-20260722-194642.png) 3. Go to **CMS > Edit.** 4. Create a Page using DIBS Payment Page under the Checkout page, then publish it. ![](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/6Dc_7jvPvvLYfzNfrqVEL-20260722-194642.png) 5. Open the site's home page, click the **Site Structure** tab, and define two new properties. 1. Set **DIBSPaymentPage** property to the DIBS page that was just created. 2. Set **DIBSPaymentLandingPage** property to the Order confirmation page. ![](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/clM8qhEj1JATZ-dm9Cbp3-20260722-194642.png) ### DIBS user experience After you deploy the files and configure the DIBS payment module on your Optimizely Customized Commerce 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. ![](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/C5fMbKeNpPCDWMohYf2fu-20260722-194642.png) 2. When you click **Place order**, you are redirected to DIBS to verify the payment. ![](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/905knMtkyF6yD0_FpugKW-20260722-194642.png) 3. When you finalize the approval process, you are redirected to the **Order confirmation** page (previously configured). ![](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/Xg93aFWnbnXRvZlY3PKR9-20260722-194642.png)