No results
BigCommerce

BigCommerce

The Nexi XPay payment extension for BigcCommerce, 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 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.

Configuration

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

  1. Log into the BigCommerce administration panel.
  2. In the left menu, click on Settings.
  3. On the new page, click on Payments.
  4. Look for the Additional Providers section, find Nexi XPay, and click on the Configure button.
  5. Proceed with the configuration of the module by selecting the XPay with API Key window:
Campo Descrizione
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
3D secure 2 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 TEST mode Enable test mode: register in the test area to receive your credentials. Test credentials can be found in the Test area section.

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 in to the BigCommerce admin panel.
  2. In the left menu, click on Settings.
  3. On the new page, click on Payments.
  4. Find and click on the Nexi XPay Settings section.
  5. Disable the TEST mode and enter the API Key generated on Nexi Business.
  6. Save the new configuration.

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.

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 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 BigCommerce administrative panel.
  2. In the left menu, click on Orders.
  3. Identify the order to be refunded, click on the three dots under the Action column, and then select the Refund option.
  4. In the new section, you can select the refund for items, for the entire order, or for a custom amount at the order level.
  5. Enter an amount and click on the Continue button at the bottom right.
  6. In the new page, select the refund method Refund customer via a third-party processor.
  7. Click on the Confirm refund button at the bottom right.

Capture

You can perform full 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.

  1. Log in to the BigCommerce admin panel.
  2. In the left menu, click on Orders.
  3. Identify the order to be captured and expand the order by clicking on the +.
  4. In the billing section, click on the Collect Funds link.
  5. In the confirmation popup for fund collection, confirm the operation.