DIBS

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 .

   📘

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

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 Customized Commerce Sample site's lang folder.
4. Deploy EPiServer.Business.Commerce.Payment.DIBS.dll to the Customized 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 folder name 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 – You need only the API UserId to let customers view. 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.
   • 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 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).