No results

Nexi XPay Build

The Nexi XPay Build payment extension for Prestashop provides the possibility to directly host the payment form within your own e-commerce website, maintaining high security standards while at the same time avoiding the need to handle payment card data.

Through this extension, the number of steps required to complete the payment is reduced.

Installation

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

It is possible to install the extension using the appropriate installer made available by Prestashop.

  1. Log in to the Prestashop 1.7/8 administrative panel.
  2. In the left navigation bar, select Modules > Module Manager .
  3. On the new page, select Upload a module at the top right.
  4. Load the plugin downloaded from the link Nexi Plugin .

The installation phase is complete, proceed with the configuration.

Configuration

Here are the instructions to correctly configure the Nexi XPay Build plugin:

  1. Log in to the Prestashop 1.7/8 administrative panel.
  2. In the left navigation bar, select Modules > Module Manager .
  3. In the new page look for the Nexi XPay Build plugin in the list and click on Configure .

Proceed with the configuration of the module:

Field Description
Enable Enable the Nexi XPay Build payment module.
Typology Select API Key
API Key Code required for communication with the XPay gateway. To obtain this data for the production or test environment, follow the instructions in the following paragraph Test and production.
Enable TEST mode Enable test mode: register in the test area to receive your credentials. Test credentials can be found in the Test area section.
Enable the 3D Secure 2 service The new 3D Secure 2 protocol adopted by the main international circuits (Visa, MasterCard, American Express), introduces new authentication methods, capable of improving and speeding up the cardholder's shopping experience.
Enable Multicurrency Available only through payment cards: enable this option to allow payment via card in various currencies. For the full list of supported currencies, visit the Multicurrency payments section of the developer portal. Make sure that this option is also enabled on your terminal configuration.

Test and production

It is highly recommended that you test the plugin in a test environment, before entering the production code.

It is possible to obtain the test credentials (API key) in the test area. In the area there will also be test cards that can be used to carry out successful and negative transactions. In this phase it is necessary to verify that the orders are created correctly, also checking the details of the orders.

Switch 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:

  1. Log in to the Prestashop 1.7/8 administrative panel.
  2. In the left navigation bar, select Modules > Module Manager.
  3. On the new page, look for the Nexi 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

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

Payment methods

The Nexi XPay plugin offers customers various payment methods:

Payment by cards

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

Pay-By-Link

This solution involves generating an order on the Prestashop side, selecting the appropriate products and the customer who wishes 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 ecommerce site.

Alternative Payment Methods (APM)

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:

Once a new payment method has been enabled from the XPay back office, it will be necessary to save the plugin configuration to update the APM list and show the new payment method in the ecommerce site checkout.

Back office functionality

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

You can perform full or partial refund operations. This operation will reverse the desired amount by reimbursing the customer. Here are the operations to perform:

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

Capture

You can perform full or partial capture operations. This operation will capture the desired amount on the XPay gateway.

By default, total capture of the amount occurs automatically at midnight, use this option only in case of non-standard terminal configurations.

Here are the steps to take:

  1. Log in to the Prestashop administrative panel.
  2. In the navigation bar on the left, select Orders .
  3. Click on the order to be refunded.
  4. In the Nexi XPay payment details section, enter the amount to be captured and click on the Capture button.