Introduction

Introduction

Dintero Checkout for WooCommerce is a plugin that extends WooCommerce allowing you to accept payments via Dintero. It replaces the standard WooCommerce checkout page.

Dintero Checkout does not support the Checkout block i WooCommerce.
You can read more about this here.


Sign up with Dintero


You need a business account with Dintero to be able to use this plugin.


Required WordPress/WooCommerce settings


  • Make sure that you have enabled pretty permalinks in your WordPress installation. Otherwise callbacks from Dintero back to your store won’t work and orders will not be updated with the correct order status/information.
  • To get the order total to match between WooCommerce and Dintero 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 have an active SSL Certificate and HTTPS activated.
  • Your checkout page must use the Classic Shortcode block. Walley Checkout does not support the Checkout block at this point. You can read more about this here

Installation


  1. Download the plugin .zip file.
  2. Go to: WordPress Admin Plugins  Add New and Upload Plugin the file you have downloaded.
  3. Install Now and Activate.

Setup and Configuration


Before you get started you need to make sure you are using the checkout shortcode on your set Checkout Page.
The Checkout block is the default for new WooCommerce installations as of version 8.3. Dintero Checkout for WooCommerce does not yet support this.

Go to Pages → your set Checkout Page and transform the Checkout block to the Classic Shortcode block.

Once you have installed the plugin and set up your Checkout page, you need to configure the plugin in accordance to the steps below:

  1. Go to: WooCommerce Settings Payments  Dintero Checkout
  2. Enable Dintero Checkout by checking the Enable Dintero Checkout checkbox.

Dintero configuration

  1. Account ID – Enter your Dintero account ID. This can be found Found under Settings → API clients in the Dintero Backoffice.
  2. Client ID – Enter your Dintero client ID. This can be found under Settings → Account in the Dintero Backoffice.
  3. Client secret – Enter your Dintero client secret. This can be generated under Settings → Account in the Dintero Backoffice.
  4. Profile ID – Enter your test payment window profile ID. Found under Settings → Payment windows in the Dintero Backoffice.
  5. Test mode – Check the Enable test mode checkbox to place the payment gateway in test mode.
  6. Logging – Check the Enable logging checkbox to save debug messages to the WooCommerce System Status log

Checkout type

Choose the type of checkout you want to use on your site – Dintero Checkout Express or Dintero Checkout.

  1. Checkout layout – Change the layout of the checkout. Choose between One column checkout, Two column checkout (Dintero checkout in right column) or Two column checkout (Dintero checkout in keft column).

Form factor

Choose if you want the checkout to be Embedded or Redirect.

Form Factor – Redirect settings

If you choose a Redirect checkout you will get some additional settings not necessary for Embedded checkout.

  1. Title – Enter the title for the payment method displayed in the checkout and order confirmation emails.
  2. Description – Enter the description of the payment method displayed in the checkout page.
  3. Logo color – Check the box to use the default logo color.
  4. Custom color – Enter a HEX color code to customize the logo color.
  5. “Go to payment” button – Customize the “Go to payment” button text that is displayed in checkout if other payment methods than Dintero Checkout are available. Leave blank to use the default (and translatable) text.

Order statuses

  1. Default order status when authorized – Choose between Processing and On-hold as the default order status when authorized.
  2. Default order status when pending authorization – Choose between Manual review and On-hold as the default order status when authorized.

Order management settings

  1. Refund by changing order status – Check this box to trigger a refund in Dintero when WooCommerce order status is manually changed to Refunded.

Dintero Checkout Express Settings

  1. Allowed customer types – Set the type of customers allowed in your store. Choose between Consumers and businesses, Business only or Consumer only.
  2. Display Shipping the in the iframe – Check this box if you want the shipping selection to happen in the Dintero checkout iframe instead of the shipping section in WooCommerce.

Order Management


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

Dintero also has their own Manual review status for orders that not yet have been authorized by Dintero.

Please note that the Order statuses below are example statuses. If you have made changes to the statuses in the Order Management settings you need to take this into consideration.

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 Update button located at the top right on the screen.
  5. If everything was successful two new order notes are created:
    • Order status changed from Processing to Completed 
    • The Dintero order has been captured. Captured amount: X

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.
  1. Here you can choose to refund the full sum for an item (1), part of the sum (2) or shipping (3).
    If you enter a sum manually (2) you also need to enter the correct tax to refund manually, as opposed to when you refund the full sum for an item in which case the tax is automatically calculated. With shipping (3) you need to enter the amount manually, as well as the tax. Not to be confused with the Refund manually button.
  1. Press the Refund via Dintero Checkout button.
  2. If everything was successful a new order note saying The Dintero order has been refunded is created.

Refund an order via order status change

If the setting Refund by changing order status is activated, a full refund in Dintero is triggered when the status of an order is changed to Refunded.


Currencies


The plugin itself has no limitations regarding currency.

However, please note that Dintero only work in the Nordic countries and there can be limitations in the agreement you have with Dintero.

When it comes to questions regarding supported currencies you should always talk to your payment provider. The exception is when the plugin in fact do have limitations.


Dintero Checkout Branding Widget


Dintero Checkout has its own Dintero Checkout Branding widget for how you want to present the Dintero logo with other means of payment.

This widget has settings for Icon color (default or custom) and Background color.

  1. Navigate to Appearance Widgets
  2. Choose the placement where you want to add the Dintero widget, e.g. Footer Column 1.
  3. Click + to Add block and search for the Dintero Checkout Branding block.
Configure the Dintero Checkout Branding block:
  1. Default icon color – Check this box to use the default icon color. Uncheck to set your own custom color.
  2. Icon color – Set your own custom color, if Default icon color is unchecked.
  3. Background color – Set your own background color.

An example of what it could look like:


Compatibility with themes & plugins


  • Dintero Checkout uses its own template file for displaying the checkout page and should work with most themes. However, the plugin is only tested with the Storefront theme and we do not guarantee that it will work with other themes. Common situations when errors occur are:
    – Themes/plugins with customized template files for WooCommerce checkout page.
    – Themes/plugins that modifies the checkout into a multi step checkout.

Krokedil and Dintero do not offer help with adapting your theme or plugin within regular support.