Prestashop

Overview

The Nexi XPay payment extension for Prestashop 1.6, 1.7, and 8, allows you to integrate the XPay payment gateway without further implementations on your site.

It manages the transfer of the customer from your E-commerce site to the secure Nexi environment and vice versa.

The customer stays on your e-commerce site until checkout, then is redirected to the XPay gateway to make the payment.

Installation

The Nexi XPay plugin for Prestahop 1.6, 1.7, and 8 is available for free at the Nexi plugin link, from which you can check compatible versions.

It is possible to install the extension through the special installer made available by Prestashop.

Prestashop 1.7 and 8

1. Login in the administrative panel of Prestashop.
2. In the left navigation bar, select Modules > Module Manager.
3. On the new page, select Upload a form in the top right.
4. Upload the downloaded plugin from the Prestashop Addons site.

The installation phase is complete, proceed with the configuration.

Prestashop 1.6

1. Login to the Prestashop admin panel.
2. In the left navigation bar, select Modules > Modules and Services.
3. On the new page, select Add New Form in the top right.
4. Upload the downloaded plugin from the Prestashop Addons site.

The installation phase is complete, proceed with the configuration.

Configuration

Here are the indications to correctly configure the Nexi XPay plugin:

Prestashop 1.7 and 8

1. Login in the administrative panel of Prestashop 1.7 or 8.
2. In the left navigation bar, select Modules > Module Manager.
3. On the new page, look for the Nexi XPTA plugin in the list and click Configure.

Prestashop 1.6

1. Login to the Prestashop 1.6 admin panel.
2. In the left navigation bar, select Modules > Modules and Services.
3. On the new page, select Payment & Gateway from the left menu.
4. On the new page, look for the Nexi XPTA plugin in the list and click Configure.

Proceed with the configuration of the module. 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 XPay module:

Test and production

It is highly recommended to test the plugin in a test environment, before entering the production codes.

You can get your test credentials (API Key) in the test environment. In the area there will also be test cards that can be used to execute successful and negative transactions. At this stage it is necessary to verify that the orders are created correctly, also checking the details of the orders.

Transition to production

To carry out the transition to production it is necessary to create the production credentials (API Key). To generate the new credentials follow these steps:

1. Log in to Nexi Business.
2. Sign in to the XPay Web Back Office.
3. In the Admin section click on APIKey.
4. Click on Add new APIKey.
5. Once the terminal has been selected, click on Add to generate the production API Key.

Once the API Key has been created, the module configuration must be updated as below:

Prestashop 1.7 and 8

1. Log in to the Prestashop administrative panel.
2. In the left navigation bar, select Modules > Module Manager.
3. On the new page, look for the Nexi XPay plugin in the list and click Configure.
4. Disable the TEST mode and enter the API Key generated on Nexi Business
5. Save the new configuration

Prestashop 1.6

1. Log in to the Prestashop administrative panel.
2. In the left navigation bar, select Modules > Modules and Services.
3. On the new page, select Payment and Gateways in the menu on the left.
4. On the new page, look for the Nexi XPay plugin in the list and click Configure.
5. Disable the TEST mode and enter the API Key generated on Nexi Business
6. Save the new configuration

It is advisable to carry out a proof of payment with a real card with the transition to production.

Payment Methods

The Nexi XPTA plugin offers customers different payment methods:

Payment by card

With this solution, the customer remains on your e-commerce until checkout. It is redirected to the Nexi environment to make the payment and then returns to the merchant's website at the end of the transaction.

OneClick Payment

The integration of this solution allows the end customer to store their credit card data, and use them later to make purchases with a few clicks. In the case of first payment XPTA will show the form for entering card data, while in the case of subsequent payments it will show a form in which to insert only the CVV (optional).

Pay-By-Link

This solution involves generating a Prestashop side order, selecting the appropriate products and the customer who wants to make the purchase.

By clicking on the button "Send an email to the customer with the link to make the payment" an email will be sent to the customer containing a link to make the payment. The customer will be redirected to the checkout page of the E-commerce site.

Alternative Payment Methods (APMs)

The plugin offers several alternative payment methods. By selecting the desired method, the customer will be redirected to the checkout page of the chosen payment service. Below is a list of supported payment methods:

• Google Pay
• Apple Pay
• MyBank
• Bancomat Pay
• Giropay
• iDEAL
• Bancontact
• PayPal

Back office functions

In the details of each order, the plugin provides information relating to transactions such as the details of the card used and the status of payments on the XPay gateway.

Refund

It is possible to perform total or partial refund operations. This operation will reverse the desired amount by reimbursing the customer. Here are the steps to do:

1. Login to the Prestashop admin panel.
2. In the left navigation bar, select Orders.
3. Click on the order to be refunded.
4. In the Nexi XPTA Payment Details section, enter the amount to be reversed and click on the Refund button.

Accounting

It is possible to perform total or partial accounting operations. This will account for the desired amount on the XPTA gateway.

By default the accounting takes place automatically at midnight, use this option only in case of non-standard configurations of the terminal.

Here are the steps to do:

Login to the Prestashop admin panel. In the left navigation bar, select Orders. Click on the order to be refunded. In the Nexi XPTA Payment Details section, enter the amount to be reversed and click on the Accounting button.