Get started

Troubleshooting

Introduction

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

Resurs Checkout supports Swedish, Norwegian and Finnish markets.

Resurs Checkout support High-Performance Order Storage (HPOS).

Click here to download the plugin.

Contact Resurs to get test credentials.
Sign an agreement with Resurs to get productions credentials.

Required WordPress/WooCommerce settings

Make sure that you have enabled pretty permalinks in your WordPress installation. Otherwise callbacks from Resurs 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 Resurs 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.

Installation

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

Setup and Configuration

Once you have installed the plugin you need to configure it in accordance to the steps below

Go to: WooCommerce → Settings → Payments → Resurs Checkout
Enable Resurs Checkout by checking the Enable Resurs Checkout payments checkbox.
Title – Enter the title for the payment method. Used only for internal purposes.
Description – Enter the description of the payment method. Used only for internal purposes.

Credentials

Production Client id – Where you enter the Client id for Resurs Banks API that you received from Resurs Bank.
Production Client secret – Where you enter the Client secret for Resurs Banks API that you received from Resurs Bank.
Test Client id – Where you enter the Test Client id for Resurs Banks API that you received from Resurs Bank. Used if Test mode is checked in the Debug section of the settings.
Test Client secret – Where you enter the Test Client secret for Resurs Banks API that you received from Resurs Bank. Used if Test mode is checked in the Debug section of the settings.

Debug

Test mode – Check the Enable test mode checkbox to place the payment gateway in test mode when using test API keys. If not checked the payment method will function in a live production environment.
Logging – Check the Log debug messages checkbox to save debug messages to the WooCommerce System Status log.
Extra logging – Check the Log extra debug data checkbox to save extra data from the request logs from the plugin. Useful for debugging issues that are hard to replicate. This will log a lot more data and should only be used when needed.

Checkout settings

Enable B2B – Check this box if you want to enable B2B purchases through Resurs Checkout.
Display cart – Check this box if you want to display the cart and its contents in the checkout.
Changeable cart – Check this box to allow the customer to modify the cart in the checkout. Requires Display cart to be checked.
Address lookup – Check this box to enable address lookup on B2C purchases by government Id. (Sweden only).
Order notes – Check this box to add a input field for customers to enter order notes before payment in the Resurs Checkout.

Checkout customization

Display name – Enter the name of your store that you want to display in the checkout.
Logo URL – Enter the URL to your logo that you want to display in the checkout.

Legacy checkout (only for the WooCommerce shortcode checkout)

Enabled shortcode support – Check this box to enable Resurs Checkout for legacy checkouts using the WooCommerce shortcode checkout page. Can be used if you are not using the checkout block provded by WooCommerce
Customize legacy checkout – If legacy checkout is enabled you can customize colors and/or margins and paddings.

Order Management

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

Resurs Checkout for WooCommerce doesn’t have a turn on/off setting for Order Management like other plugins can have.

Direct payment methods

When customers use direct payment methods such as Swish, Vipps and Trustly, the order will automatically be CAPTURED, i.e. order is paid.

Setting an order with this type of payment to Completed is not necessary to activate the order.

Activate an order for other payment methods

When customers use other payment methods that does not capture payment automatically, such as cards, invoice, part payments and more, the payment status will be set to AUTHORIZED.

To CAPTURE payment, set the WooCommerce status to Completed.

Order status in WooCommerce must be Processing and a transaction ID must be saved in the order.
Navigate to the order you wish to activate by going to WooCommerce → Orders and clicking the order.
In the order details, select the field labeled Status. Set this to Completed.
Click the button labeled Update in the top right of the page.

If the activation was successful, a note is added to the order with the text Resurs Checkout: Successfully Capture order.

Cancel an order

Order status in WooCommerce must be Processing and a transaction ID must be saved in the order.
Navigate to the order you wish to cancel by going to WooCommerce → Orders and clicking the order.
In the order details, select the field labeled Status. Set this to Cancelled.
Click the button labeled Update in the top right of the page.

If the cancelation is successful, a note is added to the order with the text Resurs Checkout: Successfully Cancelled order.

Refund an order

The WooCommerce order status need to be set as Completed.
Go to the order edit screen by navigate to → WooCommerce → Orders and click on the order you want to edit.
In the Order items box, press the Refund button.

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.

Press the Refund via Resurs Checkout button.
If everything was successful a new order note saying Refunded X kr with Resurs Checkout is created, followed by the order notes:
- Resurs Checkout: Successfully Refund order.
- Order status changed from Completed to Refunded.

Currencies

Resurs Checkout supports Swedish, Norwegian and Finnish markets and currencies.

However, please note that there can be limitations in the agreement you have with Resurs.

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.

Compatibility with themes & plugins

Resurs 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 Resurs do not offer help with adapting your theme or plugin within regular support.