No results
Wordpress

Wordpress

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

To use this plugin, the Woocommerce module must be installed on the Wordpress site.

Installation

The Nexi XPay plugin for Wordpress is available for free on the website wordpress.org, from which it will be possible to check the compatibility of the versions.

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

  1. Log into the Wordpress administrative panel.
  2. Make sure you have installed the Woocommerce plugin.
  3. In the left navigation bar, select Plugin > Add New.
  4. On the new page, enter Nexi XPay in the search bar.
  5. Locate the XPay plugin and click Install Now.

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 Wordpress administrative panel.
  2. In the left navigation bar, select Plugins > Installed plugins .
  3. On the new page look for the Nexi XPay plugin in the list and click on Settings .
  4. Proceed with the configuration of the module:
Field Description
Enable Enable the Nexi XPay payment module.
Credential type Select API Key
Integration type - Hosted payment page with redirect: the customer is redirected to XPay's external payment page.
- Build with embedded checkout: the card data entry form is integrated into the checkout.
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 OneClick This feature allows you to tokenize the customer's card data in order to allow faster subsequent payments. Make sure that this option is also enabled on your terminal configuration.
Not available for the integration type Build with embedded checkout.
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.
Enable installment payments This feature is only available to merchants with a Greek VAT number.
Enable this option to use installment payments via XPay. Before enabling this feature, please ensure it is available on your terminal through your payment service provider.

Google Pay Configuration

Google Pay can be enabled in two modes:

  • REDIRECT: default option automatically activated by Nexi on the plugin. Selecting this payment method redirects to an external XPay gateway intermediate page, from which it will be possible to pay with Google Pay. A Google Merchant account and the use of the Google Pay Business Console are not required.
  • BUTTON: a native Google Pay button is created, allowing payment without redirection to external intermediate pages. Instructions for activating this mode:
    1. Enable APM: verify that the alternative payment method (APM) is enabled on the terminal by accessing the Nexi Business portal; in the XPay Back office section, select Alternative Payments > Google Pay.
    2. Register the domain: log in to the Google Pay Business Console and register the store domain (Google Pay API > Integrate with your website). Google must approve the site before you can proceed. If you do not have a Google Merchant account, create one during the procedure.
    3. Enter merchant data: once the domain is approved, retrieve the following data from the Google Pay console:
      • Google Merchant Name
      • Google Merchant ID
    4. Set the Gateway Merchant ID: enter a unique code in this field; it is recommended to use an online UUID generator.

    Field Description
    Google merchant name Data provided by Google in the Google Pay console.
    Google merchant Id Data provided by Google in the Google Pay console.
    Google gateway merchant Id Enter a unique code in this field; it is recommended to use an online UUID generator.
    Button type Google provides different styles for the Google Pay payment button. For more information and a preview of the different types, consult the Brand guidelines page.
    Button color Background color of the Google Pay button. For more information and a preview of the different types, consult the Brand guidelines page.

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 into the Wordpress administrative panel.
  2. In the left navigation bar, select Plugins > Installed plugins .
  3. On the new page look for the Nexi plugin in the list and click on Settings .
  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 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.

Not available for the integration type Build with embedded checkout.

Recurring payment

This solution allows you to purchase products with recurring charges (eg subscriptions).

During the first payment, a token is assigned that allows Nexi to save the pairing between the user and the payment card used.

Subsequent payments will be made automatically on the date set in the subscription product settings.

To use this mode you need to install the plugin Woocommerce Subscription

Pay-By-Link

This solution involves generating an order on the Woocommerce side, selecting the appropriate products and the customer who wishes to make the purchase.

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

  1. Log into the Wordpress administrative panel.
  2. In the navigation bar on the left, select Woocommerce > Orders .
  3. Click on the order to be refunded.
  4. In the Product section click on the Refund button and select the products to be refunded.

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 Wordpress administrative panel.
  2. In the navigation bar on the left, select Woocommerce > Ordini.
  3. Click on the order to be captured.
  4. In the XPay payment details section, enter the amount to be captured and click on the Capture button.