HomeDev GuideAPI Reference
Dev GuideAPI ReferenceUser GuideGitHubNuGetDev CommunitySubmit a ticketLog In
GitHubNuGetDev CommunitySubmit a ticket

DIBS installation and configuration

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

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 .

    📘

    Note

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

    🚧

    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'sViews\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).