Checkout for Magento
This guide describes how to install, configure, and use the Checkout webshop module for Magento 1.
Before you start
Before you start, you need an Checkout Portal account. See the guide Create account for more information about creating a free test account.
Adobe Commerce, also known as Magento, announced that the Magento 1 version had its end-of-support (EOS) on June 30, 2020.
This means that Checkout is no longer actively supporting Magento 1 with any new security patches or features. This can also affect your PCI DSS (Payment Card Industry Data Security Standard) compliance. For this reason, we recommend that you migrate or upgrade to Magento 2.
Overview
Our Magento 1 plugin is the perfect extension that enables you to use the Checkout to its full potential for your Magento store. Checkout supports most popular payment methods.
You may 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.
Shop features
- The fast checkout with "remember me" functionality.
- Includes 2 checkout options for an optimized user experience: embedded checkout (users can pay from the Magento checkout confirmation page) or Checkout hosted checkout with redirect.
- A smart mix of payment methods to suit all preferences.
- Multiple checkout languages and currencies for selling in your domestic market and abroad.
The following screenshot shows a checkout page provided by the Magento plugin:
Admin Panel features
- Quick setup and flexible configuration.
- Intuitive order management with synchronized captures and refunds.
- Compatibility with discounts, tax (VAT), and shipping options.
- Compatible with multi-shop setups.
The screenshot below shows the Settings page in Magento Admin:
Installation
Follow the steps below to install the Checkout module in Magento.
Step 1: Upload the module
The first thing you need to do when installing a Magento 1 extension is to unzip the folder where the extension is stored and copy all the folders and files into the root directory of your store using FTP.
Step 2: Install the module
- Go to your Magento Admin Panel
- Go to System > Configuration > Payment Methods
- Find Checkout in the list of checkout options
- Set Enable Checkout Checkout to Yes
- Fill out your integration keys (secret keys and checkout keys) and select an order status to new orders. (Please note that orders are fully paid once they appear in the system.)
The integration keys can be found in Checkout Portal. See the following page for more help:
Step 3: Disable the standard checkout (optional)
If you wish to disable the standard checkout, you can do this in the following way:
- Go to System > Configuration > Checkout
- Under Checkout Options, in the field Enable Onepage Checkout, choose No
Step 4: Clear the cache
Finally, it's time to clear the cache to ensure that your changes take effect:
- Go to System > Cache Management
- Select all the files in the list
- Choose the refresh option in the dropdown menu
- Click the Submit button
Configuration
After installing the module, you need to do some basic configuration of the module:
- Navigate to: System > Configuration > Payment Methods
- Locate the Checkout and access Configuration.
- Fill out the required integration keys (secret keys and checkout keys).
- (Optional) Customize the module according to your needs using the additional settings on the configuration page.
The integration keys can be found in Checkout Portal. See the following page for more help:
The screenshot below shows the Checkout configuration page in the Admin Panel:
The following table lists all the settings you can configure in the administration area for the Checkout module:
| Configuration setting | Description |
|---|---|
| Enable Checkout Checkout | Activates the module. |
| Select 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. |
| Invoice fee ID | Creates a hidden (virutal) product that acts as the invoice fee. Enter the product ID in this field or leave it blank to disable. |
| Test Secret key | Your secret key for test purchases from Checkout Portal. |
| Tets Checkout key | Your checkout key for test purchases from Checkout Portal. |
| Supported customer types | Configures which customer types should be accepted on the checkout page. B2C means private customers (Business-to-Consumer). B2B means business customers (Business-to-Business). |
| Terms & Condition Direct Link | The URL to the terms and conditions of your webshop. |
| New order status | New orders placed through Checkout will set the order status to Processing. |
| 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. |
| Merchant Terms URL | The URL to your Terms of use and Cookies page. Term links can be found inside the Checkout payment window. |
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 Magento Admin Panel:
- Navigate to Sales > Orders
- Click on an order line to access order details.
- Choose your desired action, refund/partial refund, or update the order status. The Checkout plugin will synchronize automatically. The payment status will also be updated in Checkout portal.
All transactions performed by Nexi Group are accessible in Checkout Portal.
The following screenshot shows the list of orders in the Magento Admin Panel.
Troubleshooting
Below are some of the most common configuration errors, their cause and steps that you can follow to solve them.
Nexi Group payment window is blank
- Ensure your integration keys in the Nexi Group plugin settings are correct and do not contain additional blank spaces.
- Temporarily deactivate third party plugins that might affect the functionality of the plugin.
- Check if there are any temporary technical inconsistencies: https://nets.eu/Pages/operational-status.aspx
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.
Go live checklist
For more information, refer to the section Go-live checklist.