Nexi XPay

The Nexi XPay payment extension for Magento 2, allows you to integrate the XPay payment gateway without further implementation on your site.

Manages the transfer of the customer from the merchant's ecommerce site to the Nexi secure environment and vice versa.

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

---

Installation

The Nexi XPay plugin for Magento 2 is available for free on the website Adobe Commerce Marketplace, from which you will be able to check for compatible versions.

Installation via composer

Before proceeding, check that Composer is installed in your environment. Below is the list of commands to run for installation:

1. Install the plugin

2. Enable the plugin

3. Run the update command

4. Clear the cache

The installation phase is complete, proceed with the configuration.

Configuration

Here are the instructions to correctly configure the plugin:

1. Log into the Magento administrative panel.
2. In the navigation bar on the left select Stores (Stores) > Configuration (Configuration).
3. In the new menu on the left select Sales (Sales) > Payment methods (Payment methods) > Nexi XPay.
4. Proceed with the configuration of the module:

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:

• Log in to the Magento back office
• In the payment configuration section click on "Nexi"
• Disable the TEST mode and enter the API Key generated on Nexi Business
• 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.

OneClick Payment

Integrating this solution allows the end customer to store their credit card data and use it later to make purchases with just a few clicks.

In the case of the first payment, XPay will display the form for entering the card details. For subsequent payments, it will show the previously entered card information or provide the option to enter the details of a new card.

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:

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

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 refunding the customer and changing the Magento order status. Here are the operations to perform:

1. Log into the Magento administrative panel.
2. In the left navigation bar, select Sales > Orders .
3. Select the order to refund.
4. In the menu on the left select Invoices and click on the corresponding invoice.
5. Select Credit Note at the top right.
6. At the bottom of the page it is now possible to make a refund by clicking on the Refund button. There is the Adjustment fee field where you can change the amount in order to proceed with a partial refund.

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.

1. Log into the Magento administrative panel.
2. In the left navigation bar, select Sales > Orders .
3. Select the order to be captured.
4. Click on the Invoice button at the top right.
5. Click on the Submit Invoice button at the bottom of the page.