Skip to content


    This guide describes how to install, configure, and use the Nexi XPay checkout webshop module for BigCommerce.


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

    It manages the transfer of the customer from your E-commerce site to the secure Nexi environment and vice versa.

    The customer stays on your E-commerce site until checkout, then is redirected to the XPay gateway to make the payment.

    Shop features

    • A smart mix of payment methods to suit all preferences.
    • Multiple checkout languages and currencies for selling in your domestic market and abroad.
    • Fully syncronized payment statuses in admin order page with Nexi XPay merchant Back Office.
    • Intuitive order management with synchronized captures and refunds from admin order details page.

    Admin panel features

    • Quick setup and flexible configuration.
    • Intuitive order management with synchronized captures and refunds.
    • Compatibility with discounts, tax (VAT), and shipping options.


    The XPay payment method is available for free among the additional providers offered by BigCommerce. XPay activates on the checkout page once the configuration process is completed.


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

    1. Log in to the BigCommerce administrative panel.
    2. In the left menu, click Settings.
    3. On the new page, click Payments.
    4. Look for the Additional Providers section, search for Nexi and click on the Configure button.
    5. Proceed with the configuration of the module:
    API KeyCode 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
    3D secure 2The 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 TEST modeEnable test mode: register in the test area to receive your credentials. Test credentials can be found in the Test area section.

    You have installed and configured the Nexi XPay checkout webshop module. If you have any further questions, please contact Support.

    Payment methods

    Nexi XPay Plugin makes various alternative payment methods available. 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 you have enabled a new payment method from the XPay Back Office, you will need to make a saving of the configuration on the plugin configuration to update the APM list and show the new payment method in the E-commerce checkout page.

    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.


    Full or partial refund operations can be performed. This operation will reverse the desired amount by reimbursing the customer. Here are the steps to do:

    1. Log in to the BigCommerce administrative panel.
    2. In the left menu, click Orders.
    3. Identify the order to be refunded, click on the three points under the Action column and then on the Refund option.
    4. In the new section it will be possible to select the refund for items, for the entire order or at the free amount at the order level.
    5. Once you have set an amount click on the Continue button at the bottom right.
    6. On the new page, select the Refund customer through a third-party provider refund method.
    7. Click on the Confirm refund button at the bottom right.


    You can perform full metering operations. This will account for the desired amount on the payment gateway. Here are the steps to do:

    1. Log in to the BigCommerce administrative panel.
    2. In the left menu, click Orders.
    3. Identify the order to be accounted for and expand the order by clicking on the +.
    4. In the billing section, click the Acquire funds link.
    5. In the confirmation popup acquisition funds confirm the operation.

    Transition to 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 as below:

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

    Was this helpful?

    What was your feeling about it?