Checkout for PrestaShop
This guide describes how to install, configure, and use the Checkout webshop module for PrestaShop 1.5 and 1.6.
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.
Overview
Our PrestaShop 1.5 and 1.6 plugin is the perfect extension that enables you to use the Checkout to its full potential for your PrestaShop 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.
Apple Pay configuration for PrestaShop plugin is described on the Apple Pay payment method page.
Shop features
- Supports two different checkout types : Hosted Payment Window | Embedded Checkout.
- Custom and modern checkout page with Embedded Checkout.
- Fully syncronized payment statuses backend orders and Easy portal.
- Supports partial and full charge/refunds from backend order details page.
- Custom webhook events for real-time payment statuses.
- Custom Build-in debugging features.
The following screenshot shows a checkout page provided by the PrestaShop plugin:
Administration area features
- Quick setup and flexible configuration.
- Intuitive order management with synchronized captures and refunds.
- Compatibility with discounts, tax (VAT), and shipping options.
- Compatible with PrestaShop multistore feature for managing multiple shops.
The screenshot below shows the Settings page in the PrestaShop administration area:
Installation
Here's how to install the Checkout module in PrestaShop:
Upload the .zip inside the admin dashboard
- Download the plugin from: http://www.prestaworks.com/modules/81-dibs-easy-checkout.html
- Extract the zip file into
dibseasydirectory. - Create the zip archive named
dibseasy.zipwith dibseasy directory. - Login to Admin Panel.
- Click on Modules >> Module Manager tab and click on Upload a module.
- Drop your
dibseasy.zipfolder here or select from your machine. - After installation completed, press Configure.
- Set your API Credentials and configuration.
Copy to module directory
- Download the plugin from: http://www.prestaworks.com/modules/81-dibs-easy-checkout.html
- Login to Admin Panel.
- Extract the zip file into
dibseasydirectory and store it inside the module directory of PrestaShop. - After installation completed, press Configure.
- Set your API Credentials and configuration.
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:
- Go to your PrestaShop administration area
- Navigate to: Modules >> Module Manager >> Payment >> Checkout.
- Locate Checkout and click the Configure button to access the configuration.
- Fill out the required fields such as merchant ID and integration keys (secret keys and checkout keys).
- (Optional) Add Checkout related information in the order confirmation email. Use the placeholder
{dibs_html_block}in the HTML template and placeholder{dibs_txt_block}in the TXT template. - (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 in the administration area for the module:
The following table lists all the settings that can be configured in the administration area for the Checkout module:
| Configuration setting | Description |
|---|---|
| Merchant ID | Your merchant ID which can be found in Checkout Portal. |
| Live secret key | Your live secret key from Checkout Portal. |
| Test secret key | Your secret key for test purchases from Checkout Portal. |
| Live checkout key | Your live checkout key from Checkout Portal. |
| Test checkout key | Your checkout key for test purchases from Checkout Portal. |
| Use Easy Checkout | Select YES to replace the PrestaShop standard checkout with the Checkout wherein customers enter personal information. Select NO to let PrestaShop collect customer information in the standard checkout. |
| Checkout language | The language displayed on the checkout page. Default value is English. |
| Allowed customer types | Configures which customer types that should be accepted on the checkout page. B2C means private customers (Business-to-Consumer). B2B means business customers (Business-to-Business). |
| Terms & Conditions URL | The URL to the terms and conditions of your webshop. |
| Testing mode | Toggles between test mode (YES) and live mode (NO). 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. |
| 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 the privacy and cookie settings of your webshop. |
Order management
It's possible to manage orders directly in the PrestaShop administration area:
- Navigate to SELL > Orders in PrestaShop.
- Click on an order line to access order details.
- Choose your desired action. Click Partial refund or change the order status and click the UPDATE STATUS button. 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 PrestaShop administration area:
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.
Troubleshooting
Below are some of the most common configuration errors, their cause and steps that you can follow to solve them.
Nexi Group payment plugin is not visible as a payment method
- Ensure the Nexi Group plugin is available in the Modules > Module Manager > Checkout Checkout in the configuration.
- Temporarily switch to PrestaShop standard template. Custom templates might need additional changes to display correctly. Consult with your web designer or developer.
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.