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

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

(Script tags will be stripped)

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

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

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