The Nexi XPay payment extension for Shopware, 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 extension for Shopware is available for free on the website store.shopware.com, from which it will be possible to check the compatibility of the versions. To proceed with the installation, it's necessary to add the extension to the cart and proceed with the purchase using a Shopware account.

It is possible to install Nexi XPay using the appropriate installer made available by Shopware.

1. Log into the Shopware administrative panel.
2. In the left navigation bar, select Extension > Store.
3. On the new page, enter Nexi XPay in the search bar.
4. Locate the XPay extension and click Add Extension.
5. In the left navigation bar, select Extension > My extension.
6. Identify the Nexi XPay extension and click on the Install option.

The installation phase is complete, proceed with the configuration.

---

Configuration

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

1. Log into the Shopware administrative panel.
2. In the left navigation bar, select Extension > My extension.
3. Identify the Nexi XPay extension, click on the three dots, and then select the Configure option.
4. Proceed with the configuration of the module:

To obtain the api-key, 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.

---

Payment Methods Synchronization

Once the extension is configured, it's necessary to synchronize the enabled payment methods on the Nexi terminal with Shopware:

1. Login to the Shopware administrative panel.
2. In the left navigation bar, select Settings > Payment Methods.
3. Identify the Nexi XPay payment method and click on the Synchronize payment methods button.

---

Adding 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.

To enable the payment method via cards on the Shopware ecommerce:

1. Login to the Shopware administrative panel.
2. In the left navigation bar, select Sales Channels > Storefront.
3. In the new page, select General > Payment and shipping
4. Click inside the Payment methods window and select from the dropdown menu Cards | Payment cards
5. Save the settings by clicking on the Save button at the top right of the page.

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

ATTENTION: once a new payment method has been enabled from the XPay back office, it will be necessary to repeat the payment methods synchronization described in the previous paragraph.

To add alternative payment methods on the Shopware ecommerce:

1. Login to the Shopware administrative panel.
2. In the left navigation bar, select Sales Channels > Storefront.
3. In the new page, select General > Payment and shipping
4. Click inside the Payment methods window and select from the dropdown menu Cards | APM Name
5. Save the settings by clicking on the Save button at the top right of the page.

---

Back Office Functionality

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

Refund

You can perform full or partial refund operations. This operation will refund the desired amount to the customer. Below are the steps to follow:

1. Login to the Shopware administrative panel.
2. In the left menu, click on Orders > Overview.
3. Identify the order to be refunded, click on the three dots at the bottom of the row, and then select View.
4. In the new page, select the Nexi XPay tab.
5. Enter an amount and click on the Refund button.

Capture

You can perform full or partial capture operations. This operation will capture the 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.

You can perform full or partial refund operations. This operation will refund the desired amount to the customer. Below are the steps to follow:

1. Login to the Shopware administrative panel.
2. In the left menu, click on Orders > Overview.
3. Identify the order to be refunded, click on the three dots at the bottom of the row, and then select View.
4. In the new page, select the Nexi XPay tab.
5. Enter an amount and click on the Account button.