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

   Text

   

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