Checkout for Shopware 1.x
This guide describes how to install, configure, and use Checkout webshop module for Shopware 6.5
Before you start
Important
Before you start, you need a Checkout Portal account. Please refer to the guide
Compatible with Shopware 6.4 and 6.5
Note: For Shopware 6.6.x and above, please use Shopware 2.x
Please be aware that there is no upgrade path from Shopware 1.x to Shopware 2.x.
Source
Download
Overview
Our Shopware plugin is the perfect extension to enable the Nexi checkout to its full potential for your Shopware store. Checkout supports most popular payment methods.
You can see below all the payment methods offered by Checkout. This list refers to all markets.
Depending on your country or region, the list may vary. If you are uncertain about a specific payment method and whether it is available in your country or region, please contact Support for more information.
Apple Pay configuration for Shopware plugin is described on the Apple Pay payment method page.
Installation
Installation
How to install the Checkout module for Shopware 6 from github:
-
Connect with an SSH client and navigate to the root directory of your Shopware 6 installation.
-
Clone the repository by running the command: git clone git@github.com:Nets-eCom/shopware6-easy-checkout.git --branch main-1.5 --single-branch custom/plugins/NexiCheckout
After cloning run these commands:
- bin/console plugin:refresh
- bin/console plugin:install NexiCheckout
- bin/console plugin:activate NexiCheckout
- bin/build-js.sh
The module is now installed and ready to be configured for your Checkout account.
Configuration
After installing the module, you need to do some basic configuration of the module in Shopware Admin:
- Navigate to Extensions > My Extensions inside the Shopware backend/admin panel.
- Locate the Nexi Group payment plugin and press the button with three dots (...) to access the configuration.
- Fill out the required fields, such as merchant ID and integration keys (secret keys and checkout keys).
- (Optional) Customize the module according to your needs using the additional settings on the configuration page.
Both the merchant ID and the integration keys can be found in Checkout Portal. See the following pages for more help:
The screenshot below shows the configuration page for the module:
The following table lists all the settings you can configure in the administration area for the Checkout module:
| Configuration setting | Description |
|---|---|
| Payment Environment | Toggles between live mode and test mode. Choose test mode if you want to make test purchases using the test environment. There are sample card numbers and invoice addresses for testing purposes. Live mode requires an approved account. |
| Live Secret key | Your live secret key from Checkout Portal. |
| Live Checkout key | Your live checkout key from Checkout Portal. |
| Test Secret key | Your secret key for test purchases from Checkout Portal. |
| Test Checkout key | Your checkout key for test purchases from Checkout Portal. |
| Terms Url | The URL to the terms and conditions of your webshop. |
| Merchant Terms Url | The URL to the privacy and cookie settings of your webshop. |
| Checkout Flow | Select between Hosted and Embedded. Hosted loads a new payment page whereas embedded inserts the payment window directly on the checkout page. |
| Enable Auto-capture | Allows you to instantly charge a payment straight after the order is placed. Important! Capturing a payment before shipment of the order might be liable to restrictions based upon legislations set in your country. Misuse can result in your Checkout account being forfeit. |
Congratulations!
You've now installed and configured the Checkout webshop module. If you have further questions, please see the troubleshooting section below or reach out to our support.
Order management
It's possible to manage orders directly in the Shopware administration:
Navigate to Admin > Orders > Overview. Press on an order line to access order details. Go to the Details section, with the new Nexi order management component.
Now all the actions (Charge, Refund, Cancel) can be done via the new modal component.
Clicking on Max. amount will automatically pass the maximum value to the amount field.
Partials Charge & Refund
The biggest change from the currently used component is that partial charge and refund will be able to be made by selecting the item from the order list rather than manually typing out the value into the field. The list can be accessed by the checkbox field.
All transactions performed by Nexi Group are accessible in Checkout Portal.
All transactions performed by Nexi Group are accessible in Checkout Portal.
Klarna
The payment method Klarna requires a phone number to function properly. To ensure that Klarna will appear as a payment option in the Nexi Group payment window, it is essential to configure the phone number field correctly. For more information, please refer to the Klarna guide.
To add the phone number field in Shopware 6, follow these steps:
- Navigate to Settings > Shop > Log-in & Sign-up.
- Check the box for Show phone number.
- Check the box for Phone number field required.
To learn more, visit Shopware 6's documentation.
Important Note
We do not support third-party plugins that provide phone number functionality, and we cannot guarantee that their solution will be compatible with the Klarna payment method.
Payment method logos
Depending on your setup with this plugin and in case that you have multiple integrations in your checkout besides Checkout, we highly recommend you to toggle the payment method logos.
You can either:
- Download the logos separately
- Get individuals logos in HTML
- Get predefined logo bars
You can check from here to get the logos.
Troubleshooting
Below are some of the most common configuration errors, their cause and steps that you can follow to solve them.
Nexi Group payment app is not visible as a payment method
- Ensure the Nexi Group app is available in the right Sales Channel in the app configuration.
- Under the Sales Channel section, select your Shop Name under General settings. Add desired payment methods from the Nexi app.
- Temporarily switch to the Shopware 6 standard template. Custom templates might need additional changes to ensure correct display. Consult with your web designer or developer.
Nexi Group payment window is blank
- Ensure your integration keys in the Nexi Group app settings are correct and do not contain additional blank spaces.
- Temporarily deactivate third party plugins that might affect the functionality of the app.
- Check if there are any temporary technical inconsistencies: https://easy-status.developers.nets.eu/
Payments in live mode don't work
- Ensure you have an approved Live Checkout account for production.
- Ensure your Live Checkout account is approved for payments with the selected currency.
- Ensure payment method data is correct and supported by your Checkout agreement.