Virtuemart

Overview

The Nexi XPay payment extension for VirtueMart allows you to integrate the XPay payment gateway without requiring any additional implementation on your website. It manages the transfer of the customer from the merchant’s e-commerce site to the secure Nexi environment and back. The customer remains on the merchant’s e-commerce site until the checkout stage, and is then redirected to the XPay gateway to complete the payment.

Shop features

• 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.
• Supported currencies: please see in the following link all the supported currencies
• The option to show each payment method as separate option, before loading the checkout.
• Supported languages: The Nexi XPay checkout is automatically displayed in the same language used on your store.

Admin panel features

• Quick setup and flexible configuration.
• Intuitive order management with synchronized captures and refunds.
• Compatible with discounts, tax (VAT) and shipping variants.
• Quick setup and flexible configuration.
• The screenshot below shows the Settings page in the Magento administration portal:

Installation

The Nexi XPay plugin for VirtueMart is available free of charge on the Joomla Extensions Directory, where you can verify compatible versions.

The extension can be installed using the Extension Manager installer provided by Joomla:

1. Log in to the Joomla administration panel.
2. In the top navigation bar, select Extensions > Manage.
3. Upload the file downloaded from the Joomla Extensions Directory.
4. From the left-hand menu, select Manage.
5. Search for Nexi XPay in the list.
6. Enable the extension by clicking the appropriate button.
7. In the top navigation bar, select VirtueMart > Payment Methods.
8. On the new page, select the Nexi XPay plugin from the list and click the Edit button.
9. Click the New button at the top of the page.
10. On the new page, enter Nexi XPay in the Payment Name field and select Nexi XPay as the Payment Method.
11. Click the Save button at the top of the page.

The installation phase is now complete. You can proceed with the configuration.

Configuration

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

1. Log in to the Joomla administration panel.
2. In the top navigation bar, select VirtueMart > Payment Methods.
3. On the new page, click on the Nexi XPay plugin from the list.
4. Select the Configuration section.
5. Proceed with configuring the 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. Waiting for Onboarding email for the service in order to reset the password that has been sent via mail to the merchant, in order to access for the first time on the merchant Back office.

2. Sign in to the XPay merchant Back office.

3. In the Settings section, click on API Key.

4. Click on Generate new API Key.

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:

6. Log in to the Magento Back office.

7. In the payment configuration section click on Nexi.

8. Disable the TEST mode and enter the API Key generated on merchant Back office.

9. Save the new configuration.

Payment methods

Card Payments

With this solution, the customer remains on the merchant’s e-commerce site until the checkout stage. They are then redirected to the secure Nexi environment to complete the payment and, once the transaction is finished, are redirected back to the merchant’s website.

Alternative Payment Methods (APMs)

The plugin also offers various alternative payment methods. By selecting the desired method, the customer is redirected to the checkout page of the chosen payment service.

Below is the list of supported alternative payment methods:

• Google Pay
• Apple Pay