HomeDev GuideAPI Reference
Dev GuideAPI ReferenceUser GuideGitHubNuGetDev CommunityDoc feedbackLog In
GitHubNuGetDev CommunityDoc feedback

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


    To avoid assembly conflicts, install the Optimizely Customized Commerce Core version that your site is using. Also, apply no database transforms.


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


  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. 

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

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


  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.

    1. Set **DIBSPaymentPage** property to the DIBS page that was just created.

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


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