Get started

Customization

Troubleshooting

Home
/
Nexi Checkout
/
Get started
/
Introduction

Introduction

Nexi Checkout was previously known as Nets Easy (and DIBS Easy before that) and there may be some remnants of this in the documentation or plugin. For instance in the code snippets and/or some of the settings.

Nexi Checkout is a plugin that extends WooCommerce, allowing you to take payments via Nexi.

The plugin can be downloaded for free here.

Nexi Checkout supports the Checkout block in WooCommerce when using the Redirect checkout flow as of version 2.8.0

Nexi Checkout does not support the Checkout block in WooCommerce when using the Embedded or Overlay checkout flows. Both these flows will instead be converted to the Redirect checkout flow.

You can read more about Checkout block support here.

To get started with Nexi Checkout, you need to create an account with Nexi. 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.

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

Installation

Login to WordPress Admin. Navigate to Plugins → Add New (in the left column menu).
Click on the Upload Plugin 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/WooCommerce settings

You need to enable HTTPS (install a SSL/TLS certificate) in your web store to get Nexi Checkout to work.
Make sure that you have enabled pretty permalinks in your WordPress installation. Otherwise callbacks from Nexi back to your store won’t work and orders will not be updated with the correct order status/information.
It’s important that callbacks from Nexi to your store doesn’t get blocked by security or caching plugins. Make sure that requests to https://yourdomain.com/wc-api/ isn’t blocked.
To get the order total to match between WooCommerce and Nexi 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.
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.
Your checkout page must use the Classic Shortcode block. Nexi Checkout does not support the Checkout block at this point. You can read more about this here.

Configuration

Before you get started you need to make sure you are using the checkout shortcode on your set Checkout Page if you want to use the Embedded or the Overlay checkout flow.
The Checkout block is the default for new WooCommerce installations as of version 8.3. Nexi Checkout does not yet fully support this unless you use the Redirect checkout flow.

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

Settings

Navigate to → WooCommerce → Settings → Payments → Nexi Checkout

Enable Nexi Checkout by checking the Enable Nexi Checkout checkbox.
Title – Enter the title for the payment method displayed in the checkout and order confirmation emails.
Description – Enter the description of the payment method displayed in the checkout page.
Merchant ID – Enter your Nexi Checkout Merchant ID. Only required if you are a partner and are initiating the checkout with your partner keys.
Live Secret key – Enter your live secret key received from Nexi.
Live Checkout key – Enter your live checkout key received from Nexi.
Test Secret key – Enter your secret key for test purchases received from Nexi.
Test Checkout key – Enter your checkout key for test purchases received from Nexi.
Test mode – Tick the checkbox if you make purchases using the test credentials.
Allowed Customer Types – Select if you want to sell both to consumers and companies or only to one of them.
Email text – Custom text that will be added to the order confirmation email sent to the customer.
Email payment data – Check this box to add Nexi payment data to order confirmation email.
Manage orders – Check this box if you want to cancel an order in Nexi’s system automatically when the order is marked as Cancelled in WooCommerce and charge an order in Nexi’s system automatically when the order is marked as Completed in WooCommerce.
Logging – Enable debug logging. Stores requests and responses between WooCommerce and Nexi in a log file. Can be found by navigating to WooCommerce → Status → Logs.
Invoice fee ID – Create a hidden (simple) product that acts as the invoice fee. Enter the product ID number in this textfield (not the SKU). Leave blank to disable.
Checkout flow – Select how Nexi Checkout should be integrated in WooCommerce.
Embedded – the checkout is embedded in the WooCommerce checkout page and partially replaces the checkout form.
Redirect – the customer is redirected to a payment page hosted by Nexi.
Overlay – similar logic as redirect flow but the hosted payment window is displayed in an overlay on desktop.
Auto-capture – Check this box to automatically charge the customer directly when the purchase is done. This is a feature that is mainly used when selling digital goods (where there is no shipping of goods included). The order will only instantly be set to Completed in WooCommerce if it’s digital goods and no shipping is required.
Other payment method button text – Customize the Select another payment method button text that is displayed in checkout if using other payment methods than Nexi Checkout. Leave blank to use the default (and translatable) text.
Subscription payment button text – Select which text you want on the Complete payment button. Only applicable for subscription based payments.
Subscription type – If using Nexi Checkout together with Woo Subscriptions, select the subscription type to use. Chose between Scheduled subscriptions and Unscheduled subscriptions.
You can read more about the differences here.
Payment gateway icon – Enter an URL to the icon you want to display for the payment method. Use default to display the default Nexi logo. Leave blank to not show an icon at all.
Learn more how to add a custom logo.
Payment gateway icon width – Specify the max width (in px) of the payment gateway icon.

Standalone payment methods

Enable specific payment methods as standalone payment methods in the checkout.

Card payment – Check this box to enable Card payment as separate payment method.
Swish payment – Check this box to enable Swish payment as separate payment method.

After one, or more, of the standalone payment methods has been enabled, they appear as Payment Methods when you navigate back to WooCommerce → Settings → Payments

Configuration standalone payment methods

Click on the Payment Method you wish to configure to access the settings.

Enable the Nexi Checkout standalone payment method by checking the Enable/Disable checkbox.
Title – Enter the title for the payment method displayed in the checkout and order confirmation emails.
Description – Enter the description of the payment method displayed in the checkout page.
Payment gateway icon – Enter an URL to the icon you want to display for the payment method. Use default to display the default Nexi logo. Leave blank to not show an icon at all.
Payment gateway icon width – Specify the max width (in px) of the payment gateway icon.

Checkout language

The plugin does automatically display the Nexi Checkout checkout in the same language used on the website. Current supported locales are Swedish, Norwegian, Danish, English, German, Polish, French, Dutch, Finnish and Spanish.

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.

Change the language of your website:

Go to the admin page.
On the left panel, click on Settings (for WordPress, not for WooCommerce).
Change the Site Language option to the language of your choice.
Save changes.

Currencies

The plugin itself has no limitations regarding currency.

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

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.

You can see what currencies Nexi support and read about their Multicurrency solution here.

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
Nexi Payment ID
Nexi Checkout Payment type
Masked card number

Subscription support

Nexi Checkout is compatible with the WooCommerce Subscriptions extension for handling of recurring payments.

Read more about recurring payments with Nexi Checkout in our Nexi Checkout Subscription support section or on the Nexi Checkout Docs site.

Order management

When an order is created in WooCommerce and a reservation number exists in Nexi’s system, you have the possibility to handle the order management in Nexi 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 Nexi via your WooCommerce store, you need to activate Manage orders settings in the payment getaway settings.

Cancel an order

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

Activate an order

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

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 Nexi Checkout button.
If everything was successful a new order note is created with information about the refund in Nexi’s system

Compatibility with themes & plugins

Nexi 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.

Read more about compatibility on these links:
Compatible plugins
Known compatibility issues

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