DIBS Easy for WooCommerce

Introduction

DIBS Easy for WooCommerce is a plugin that extends WooCommerce, allowing you to take payments via DIBS new payment method DIBS Easy.

The plugin can be downloaded for free here.

Limitations in functionality

DIBS Easy is an embedded checkout, a checkout solution that replaces the standard WooCommerce checkout form. This setup provides an easy way for the customer to complete the purchase and a convenient way for the merchant to offer multiple payment options in the same solution.

An embedded checkout also implies certain limitations in functionality. Compatibility with other plugins that extend the functionality of the standard checkout might be limited. Examples of features that might not work out of the box:

  • Selection of Delivery Date.
  • Extra checkout fields (besides the standard billing and shipping fields).
  • Newsletter subscription signup.
  • Create an account during checkout process where the customer gets the opportunity to select user name and password (however, this can be generated automatically in WooCommerce).

Sign up with DIBS

To get started with DIBS Easy, you need to create an account with DIBS. If you’re not a customer yet you can register here.

Testing

If you want to try the checkout before installing it in your store you can checkout our demo store here. You can also sign up for a test account so you can test it in your own WooCommerce store.

If you want to test the checkout quickly and don’t have the need to access the DIBS backoffice you can use the following credentials:

Test Secret Key: test-secret-key-b90412a5926f4f8196d060f6d9928ac1
Test Checkout Key: test-checkout-key-4b9f3a221cd94dbfbe70ee819ddb6c14

To make test purchases you also need customer test data. This information can be found here.

Installation

  • Login to your WordPress Admin. Click on Plugins | Add New from the left hand menu
  • Click on the Upload option, then click Browse to select the zip file from your computer. Once selected, press OK and press the Install Now button.
  • Activate the plugin.

Required WordPress settings

  • You need to enable HTTPS (install a SSL/TLS certificate) in your web store to get DIBS Easy to work.
  • To get the order total to match between WooCommerce and DIBS you need to configure WooCommerce to display prices with 2 decimals. More information about displaying of prices and how it can cause rounding issues can be found in this article.
  • You need to enable Guest Checkout (or let WooCommerce generate user name and password automatically when creating an account) in your store, otherwise the order will not be finalized in WooCommerce when paying with DIBS Easy.
  • It’s recommended to add/use SKU on products (even on product variants). This is needed to keep track of purchased products in orders between the two systems and to make refunds working properly.

Configuration

  1. Navigate to → WooCommerceSettingsCheckout.
  2. Now DIBS Easy appears as an available payment method in the horizontal menu at the top. Click on this link to get to the settings page for the payment method.
  3. Enable / Disable – Tick the checkbox if you want the payment method should be available at checkout.
  4. Title – Enter the title for the payment method displayed in the checkout and order confirmation emails.
  5. Live Secret key – Your live secret key received from DIBS.
  6. Live Checkout key – Your live checkout key received from DIBS.
  7. Test Secret key – your secret key for test purchases received from DIBS.
  8. Test Checkout key – Your checkout key for test purchases received from DIBS.
  9. Test mode – Tick the checkbox if you make purchases using the test credentials.
  10. Manage orders – Check this box if you want to cancel an order in DIBS system automatically when the order is marked as Cancelled in WooCommerce and charge an order in DIBS system automatically when the order is marked as Completed in WooCommerce.
  11. Email text – custom text that will be added to the order confirmation email sent to the customer.

 

Checkout language

The plugin does automatically display the Easy checkout in the same language used on the website. Current supported locales are Swedish, Norwegian, Danish and English.

The plugin is using the WordPress function get_locale() to determine the current language. If no language match is found the checkout will be displayed in English.

Order emails

Besides the text added in the Email text settings field, the payment gateway adds extra info in order emails sent to the customer. The following information is added below the order review table:

  • Order date
  • DIBS Payment ID
  • DIBS Easy Payment type
  • Masked card number

Subscription support

DIBS Easy is compatible with the WooCommerce Subscriptions extension for handling of recurring payments.

Read more about recurring payments with DIBS Easy here.

Order management

When an order is created in WooCommerce and a reservation number exists in DIBS system, you have the possibility to handle the order management in DIBS directly from WooCommerce. This way you can save time and don’t have to work in both systems simultaneously.

Requirements

To get started with order management in DIBS via your WooCommerce store, you need to activate Manage orders settings in the payment getaway settings.

Cancel an order

  1. The WooCommerce order status need to be set as Processing.
  2. Go to the order edit screen by navigate to → WooCommerce → Orders and click on the order you want to edit.
  3. In the Order details box there is a selectbox named Order status. Change the status to Cancelled.
  4. Click the Save Order button located at the top right on the screen.
  5. If everything was successful a new order note saying DIBS order cancellation completed is created.

Activate an order

  1. The WooCommerce order status need to be set as Processing.
  2. Go to the order edit screen by navigate to → WooCommerce → Orders and click on the order you want to edit.
  3. In the Order details box there is a selectbox named Order status. Change the status to Completed.
  4. Click the Save Order button located at the top right on the screen.
  5. If everything was successful a new order note is created with information about the activation in DIBS system.

Refund an order

  1. The WooCommerce order status need to be set as Completed.
  2. Go to the order edit screen by navigate to → WooCommerce → Orders and click on the order you want to edit.
  3. In the Order items box, press the Refund button.
  4. To make a full refund for the entire order, enter the Order total amount in the Refund amount text field. At the moment only full refunds are supported by the payment gateway.
  5. Press the Refund via DIBS Easy button.
  6. If everything was successful a new order note is created with information about the refund in DIBS system.

Before you go live

When you are finished with the installation and configuration your web store needs to fullfil a number of criterias before DIBS can approve your store.

Information about these criterias can be found in DIBS site inspection information here.