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.

The extension is just released

The extension is just launched. Any bugs, questions or suggestions for changes can be reported to support@krokedil.se.

The DIBS Easy payment window is integrated/displayed directly in your checkout via an iframe solution. This means that the display of the iframe may vary between different themes. In some themes the display may look strange or incorrect. The reason is that the markup of the theme is different from WooCommerce’s normal markup. Contact us for more info if the checkout iframe is displayed incorrectly in your theme.

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.

 

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

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.