DIBS installation and configuration

This topic describes how to install and use the DIBS payment provider, one of several Episerver Commerce payment solutions.

In this topic

• Deployment
• Build DIBS project
• Commerce Manager
• Front-end site Webform (Sample site)
• Front-end site MVC (Quicksilver)
• DIBS configuration
  • Setup DIBS payment provider in Commerce Manager
  • Setup DIBS payment provider in front-end site
  • DIBS user experience
  • Using Split payment

Deployment

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 .

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

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

Commerce Manager

1. Find the Commerce Manager Apps folder, located under the Episerver 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. 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

Setting up the DIBS payment provider in Commerce Manager

After deploying all necessary files, follow these steps.

1. Open the Episerver 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.
     
     Image

     

     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 documentation for more information.
• MD5 keys 1 and 2. MD5-keys to secure data sent between your system and DIBS.
  Image

  

  The key values are available from the DIBS Administration interface (Integration > MD5 Keys):

  Image

  

  Note that you need the DIBS API to return enough information to process an order.
  So make sure Order ID and All fields exclusive of card information response... (in Integration > Return Values section) were checked.

  Image

  

  7. Click the Markets tab and add the expected markets for this payment.

  Image

  

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. Navigate 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.
   Image

   
3. Navigate 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.

Image

DIBS user experience

After you deploy the files and configure the DIBS payment module on your Episerver 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.
   
   Image

   
2. When you click Place order, you are redirected to DIBS to verify the payment.
   
   Image

   
3. When you finalize the approval process, you are redirected to the Order confirmation page (previously configured).
   
   Image

   

Using Split payments

To support Split payments:

1. Open the DIBSRequestHelper.cs file.
2. Go to the PostRequest method.
3. Comment the line of code

   request.Add("force", "yes");

4. Uncomment the line of code

   request.Add("splitpay", "true");

You also need to enable Split Payments for your DIBS account. See http://tech.dibspayment.com/flexwin_api_other_features_split_payment for more information.

DIBSPaymentOption

Last updated: Jan 08, 2019