BigCommerce

BigCommerce

Nexi XPay Payment Extension for BigCommerce

The Nexi XPay payment extension for BigCommerce allows you to integrate the XPay payment gateway without any additional implementation on your site.

It manages the transfer of the customer from the merchant’s e-commerce site to the Nexi secure environment and vice versa.

The customer remains on the merchant’s e-commerce site until checkout and is then redirected to the XPay gateway to complete the payment.

Installation

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

Configuration

Follow the steps below to correctly configure the Nexi XPay plugin:

1. Log into the BigCommerce administration panel.
2. In the left menu, click Settings.
3. On the new page, click Payments.
4. In the Additional Providers section, find Nexi XPay and click Configure.
5. Proceed with the module configuration by selecting XPay with API Key.

Configuration Fields

Test and Production

It is highly recommended to test the plugin in a test environment before switching to production.

Test credentials (API Key) can be obtained from the test area. This area also provides test cards that can be used to perform successful and negative transactions.

During this phase, verify that:

• Orders are created correctly
• Order details are correctly populated

Switch to Production

To move to production, you must create production credentials (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 APIKey.
4. Click Add new APIKey.
5. Select the terminal and click Add to generate the production API Key.

Update the Module Configuration

1. Log in to the BigCommerce admin panel.
2. In the left menu, click Settings.
3. Click Payments.
4. Find and open the Nexi XPay Settings section.
5. Disable TEST mode and enter the production API Key.
6. Save the configuration.

Payment Methods

The Nexi XPay plugin offers customers multiple payment methods.

Payment by Cards

With this solution, the customer remains on the merchant’s e-commerce site until checkout, is redirected to the Nexi environment to complete the payment, and then returned to the merchant’s website at the end of the transaction.

Alternative Payment Methods (APM)

The plugin supports several alternative payment methods. When a method is selected, the customer is redirected to the checkout page of the chosen payment service.

Supported APMs include:

• Google Pay
• Apple Pay
• PayPal
• PayPal – Paga in 3 rate
• PagoinConto
• Bancomat Pay
• MyBank
• Giropay
• iDEAL
• Bancontact
• Multibanco

Once a new payment method is enabled in the XPay Back Office, you must save the plugin configuration to refresh the APM list and display the new method on the e-commerce checkout page.

Back Office Functionality

Within each order’s details, the plugin provides transaction-related information, such as:

• Card details
• Payment status on the XPay gateway

Refund

You can perform full or partial refunds. Follow these steps:

1. Log in to the BigCommerce administrative panel.
2. In the left menu, click Orders.
3. Locate the order to refund, click the three dots under the Action column, and select Refund.
4. Choose whether to refund:
   • Specific items
   • The entire order
   • A custom amount at order level
5. Enter the amount and click Continue.
6. Select Refund customer via a third-party processor.
7. Click Confirm refund.

Capture

You can perform full capture operations to capture the amount on the XPay gateway.

By default, the total amount is automatically captured at midnight. Use manual capture only in case of non-standard terminal configurations.

To capture a payment manually:

1. Log in to the BigCommerce admin panel.
2. In the left menu, click Orders.
3. Locate the order and expand it by clicking the + icon.
4. In the billing section, click Collect Funds.
5. Confirm the operation in the popup.