Introduction

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

Qliro does not support the Checkout block in WooCommerce.
You can read more about this here.

Sign up with Qliro

You need to have an agreement with Qliro 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 Qliro 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 Qliro you need to configure WooCommerce to display prices with 2 decimals. More information about display 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. Qliro does not support the Checkout block at this point. You can read more about this here.
• You can not alter, or add to, the [woocommerce_checkout] shortcode when this is used.

---

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. Qliro for WooCommerce does not yet support this.

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

General configuration

Get started with Qliro for WooCommerce by adding the API credentials you recieved from Qliro and enable Qliro as a payment method.

1. Go to: WooCommerce → Settings → Payments → Qliro
2. Enable Qliro by checking the Enable Qliro as a payment method checkbox.
3. Title – Enter the title for the payment method displayed in the checkout and order confirmation emails.
4. Description – Enter the description of the payment method displayed in the checkout page.

API Credentials

5. Production Qliro API key – Where you enter the API key received from Qliro.
6. Production Qliro API Secret – Where you enter the API Password received from Qliro.
7. Test Qliro API key – Where you enter the API Test key received from Qliro. Used if Test mode is checked above.
8. Test Qliro API Password – Where you enter the API Test Password received from Qliro. Used if Test mode is checked above.

Debug

9. 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.
10. Advanced demo mode – Check this box to Enable advanced demo mode, making it possible to test the Qliro payment solution in your store, without enabling Qliro for all customers.
    For more information, see the Advanced demo mode section.
11. Logging – Check the Log debug messages to save debug messages to the WooCommerce System Status log.

Checkout configuration

Configure your checkout in relation to shipping, B2C/B2B purchases, newsletter signup and risk mitigations.

1. Shipping within the Qliro iframe – Select if/how you want to integrate and display the shipping options inside of the Qliro checkout iframe.
   Choose between No, WooCommerce shipping methods and Qliro integrated shipping with Ingrid.
2. Shipping section description – If WooCommerce shipping methods is selected in the setting above, you can display a custom text right under the shipping section’s main title.

3. Country selector placement – Enables the possibility to switch billing country from the checkout page. Choose where on the checkout page you want it to be visible.
   Choose between Inactive/shortcode placement, Above checkout form, Above order preview, Above payment form, Below order review, Below payment form and Below checkout form.
4. Allowed customer types – Qliro supports both B2C and B2B checkout flows. Select which flow you wish to use for you checkout.
   Choose between Both B2C & B2C, Only B2C and Only B2B.
5. Ask for newsletter signup – Check this box to display a newsletter sign-up checkbox for your customers. You can read more about how this is handled under Newsletter settings.
6. Ask for newsletter signup checked by default – Check this box to display an already checked newsletter sign-up checkbox for your customers. You can read more about how this is handled under Newsletter settings.

Risk mitigation

7. Minimum customer age – Set the minimum customer age for all purchases.
   This can also be set on an individual product level.
   Please note that if this setting is active it prevents B2B purchases.
8. Require identity verification – Check this box to verify customers identity with BankID in Sweden.
   Please note that this can lead to a double BankID verification requirement in certain instances.
9. Has risk – Check this box to flag all products as high-risk.
   This can also be set on an individual product level.

Upsell on WooCommerce thank you page

The plugin Post Purchase Upsell for WooCommerce is needed to enable upsell on the WooCommerce thank you page.

10. Upsell Percentage – Set the max amount above the order value a customer can add to a Qliro order paid with After Delivery payment. The default is 10%. If you want a higher percentage you first need to contact Qliro as this is regulated in your deal with them.

Please note that if you have Shipping within the Qliro iframe setting active, you need to have the correct shipping methods set up under WooCommerce → Settings → Shipping.
Read more about how to set up shipping in the iframe.

Order management settings

Manage settings related to an order after it has been created, such as when capture and cancelation with Qliro should be initiated etc.

If you don’t want to use Order Management you use the statuses None where applicable.

1. Capture order status – Select what WooCommerce order status to use to initiate capturing the order in Qliros system.
   For example, if this is set to Completed (recommended) it means that when an order is set to Completed in WooCommerce, the capture in Qliros system is initiated.
2. Cancel order status – Select what WooCommerce order status to use to initiate canceling the order in Qliros system.
3. Calculate return fee – Check this box to calculate return fee when returning items automatically, if the refunded amount of an order line is less than the unit amount.
   This setting is required for partial refunds.
4. Advanced pending status configuration – Check this box to enable advanced pending status configuration. This should only be used in advanced situations.

Advanced order management settings

5. Pending capture order status – Select what WooCommerce order status to set the order to while WooCommerce waits for Qliro to tell us if the capture was successful or not.
6. OK capture order status – Select what WooCommerce order status to set the order to when we get notified of a successful order capture from Qliro.
7. Pending cancel order status – Select what WooCommerce order status to set the order to while we wait for Qliro to tell us if the cancellation was successful or not.
8. OK cancel order status – Select what WooCommerce order status to set the order to when we get notified of a successful order cancellation from Qliro.

Please note that there can be issues when you deviate from the default plugin settings. Make sure you test your order flow after making changes to confirm everything is working as expected.

Checkout customization

Customize your checkout related to page layout, other payment method button text, colors and corner radius to make the look and feel of the checkout fit into your website in the best possible way.

1. Checkout page layout – Choose the Checkout layout – One column checkout, Two column checkout (Qliro in right column), Two column checkout (Qliro in left column) or Two column checkout (Qliro in left column) – Storefront light.
2. Customize other payment method button text – Customize the Select another payment method button text that is displayed in checkout if using other payment methods than Qliro. Leave blank to use the default (and translatable) text.
3. Background color – Define the background color to use in the Qliro checkout iframe.
4. Primary color – Define the color for the selected options throughout the checkout.
5. Call to action color – Define the color for the Call to action-buttons throughout the checkout.
6. Call to action hover color – Define the hover color for the Call to action-buttons throughout the checkout.
7. Corner radius – Set a pixel value for rounded corners throughout the checkout. Leave blank, or set 0, for hard corners.
8. Button corner radius – Set a pixel value for rounded corners on Call to action-buttons throughout the checkout. Leave blank, or set 0, for hard corners.

Please note that if you have made changes in the Checkout Customization that you can not see in your checkout you can try and view your site in a different browser or incognito mode.

You can also Clear customer sessions under WooCommerce → Tools

Widgets

Setup Qliro payment widgets and banner widgets on your website.

Banner widget

Promote Qliro payment methods and campaigns, without having to manually update banners continuously. You can also display it with the shortcode [qliro_one_banner_widget], read more about it here.

1. Banner widget payment method – Select the payment method to be presented in the banner widget.
   Choose between Campaign, Invoice and Part payment.
2. Banner widget placement on product pages – Select where you want the banner to be displayed – Inactive/shortcode placement, Above title, Between Title and Price, Between Price and Excerpt, Between Excerpt and Add to cart button, Between Add to cart button and Product meta, Between Product meta and Product sharing buttons or after Product sharing buttons.
3. Banner widget placement on cart page – Select where you want the banner to be displayed – Above cross-sell, Above cart totals, Between cart totals and Proceed to checkout button or at the Bottom of the page.
4. Banner widget styled shadow – Check this box to display the banner with a Qliro style shadow.

Product widget

Presents a suitable payment method based on the price of the current product. You can also display it with the shortcode [qliro_one_payment_widget], read more about it here.

1. Payment widget placement on product pages – Select where you want the banner to be displayed – Inactive/shortcode placement, Above title, Between Title and Price, Between Price and Excerpt, Between Excerpt and Add to cart button, Between Add to cart button and Product meta, Between Product meta and Product sharing buttons or after Product sharing buttons.
2. Payment widget condensed copy – Check this box to display the payment widget in a more condensed and shorter style.

Product level settings

Some of the settings available in the Risk mitigation part of the Checkout configuration settings can be applied on a product level instead of store-wide. This is useful if the settings don’t have to apply to all products.

Navigate to Products → All Products and click on the product you wish to configure.
Below the Product description metabox you will find the box called Product data. In this box you have the tab Qliro.

1. Minimum customer age – Set the minimum customer age for this product.
2. Require ID verification – If this box is checked and the customer is from Sweden, identity verification with BankID will be required for every purchase of this product.
   This can result in a double BankID verification requirement in some cases.
3. Has risk – Check this box to flag this product as high-risk.

Country selector

With Qliro for WooCommerce you have the option to display a country selector on your checkout page(s) when Qliro is the chosen payment method.

You have the option to choose between:

• Inactive/shortcode placement
• Above checkout form
• Above order review
• Above payment form
• Below order review
• Below payment form
• Below checkout form

If you choose Inactive/shortcode placement, this is the shortcode to use: qliro_country_selector

Order Management

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

Read more about order management in Qliros system directly from WooCommerce in the Qliro Order management documentation.

Subscription support

Qliro is compatible with the WooCommerce Subscriptions extension for handling recurring payments.

Read more about recurring payments with Qliro here.

Currencies

The plugin itself has no limitations regarding currency.

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

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