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


Describes how to install and use the DIBS payment provider, one of several Optimizely Customized Commerce 13 payment solutions.

Install DIBS

Follow these steps to deploy the DIBS payment provider.

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 Commerce Core version that your site is using. Also, apply no database transforms.



    If you are using Commerce 11 or higher, ignore step 4. That code was removed from 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:

File Description

For Commerce versions 10.5 and 11


For Commerce 12 versions and up


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


For Commerce 12 versions and up


front-end mvc view
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.

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

    • API UserId – The user for the DIBS administration page.
    • 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.
    • Processing Url – The URL to process a DIBS payment, usually https://payment.architrade.com/paymentweb/start.action.
      See DIBS documentationfor more information.
    • 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 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).