Nexi XPay Payment



Magento Platform
Open Source (CE)
2.0, 2.1, 2.2, 2.3
Commerce using on prem (EE)
2.0, 2.1

Tech Specifications

Current Version:
Stable Build
17 March, 2020
Extensions, Payments & Security, Payment Integration


This extension integrates the X-Pay payment gateway by Nexi (previously owned by CartaSì). The same platform was also used by KeyClient's QuiPago gateway.


Back to top

This extension adds a new payment method to Magento that integrates the services provided by the X-Pay payment gateway, which is used by Nexi to provide payment services for italian merchants. The same platform was previously provided by CartaSì and is also used by KeyClient's QuiPago. These payment services help merchants to start receiving payments online by credit card.

The extension allows a merchant to receive payments on their Nexi bank accounts using the X-Pay gateway. The payment method provided by this extension is used to accept credit card payments. It is possible to choose the language that the payment page will be shown in (5 languages available at the time of writing).

During the checkout process, if a customer chooses the payment method provided by this extension, he/she will be redirected to the payment page hosted by the payment provider. This page allows the customer to choose whether to pay by credit card, by MyBank or by other payment methods that the merchant may have enabled in X-Pay's backoffice.

When the customer completes the payment he/she will be redirected to the Magento default thank you page (or to the failure page if the transaction was not approved).

Every order placed using this payment method will be automatically updated with the outcome of the payment transaction as soon as the payment provider notifies Magento about this outcome. This happens using a server-to-server call which is automatically handled by this extension.

The extension receives and handles the server-to-server payment notification. If the payment is successful the related order will be set automatically to the processing state. If the payment action is Authorize & Capture also the invoice will be automatically created. In case of errors it is possible to configure the extension to either leave the order in the "pending payment" state, or to automatically cancel it.


Account & Pricing

To use this extension you need to sign up to X-Pay service here. Transaction fees will be charged for every transaction. Transaction fees vary from merchant to merchant. The amout of the fee has to be agreed upon with Nexi directly..



  • Supports credit card payments;
  • Supports MyBank payments;
  • No sensitive data is stored in the merchant's store;
  • Easy test mode setup: the extension is preconfigured to easly test payment process through X-Pay's testing environment;
  • Multiple store views fully supported;
  • Both payment actions Only Authorize and Authorize & Capture are fully supported;
  • Ability to choose the payment page language (which can be different on each store view, 5 languages available);
  • Ability to choose on which country the payment is applicable;
  • Ability to set a minimun and maximum order total for the payment;
  • Ability to choose which the MAC encryption method (SHA1 or MD5);
  • Ability to to enable automatic order cancel when payment fails.



Since all payment information are inserted on the bank's payment page, no credit card data (or other sensitive data) will be sent to your Magento store. This means that you don't have to worry about security and PCI compliance.


User Guide

You can find user guide documentation at the following links:

Release Notes

Back to top


  • Compatible with Open Source (CE) : 2.1 2.2 2.3
  • Stability: Stable Build
  • Description:

    Magento 2.3 compatibility fixes


  • Compatible with Open Source (CE) : 2.1 2.2
  • Stability: Stable Build
  • Description:

    - Added Magento 2.2.* compatibility
    - Improved validation of payment parameters
    - Minor refactoring


  • Compatible with Open Source (CE) : 2.0 2.1
  • Compatible with Commerce using on prem (EE) : 2.0 2.1
  • Stability: Stable Build
  • Description:

    - Now the extension checks if the required dependency library (webgriffe/lib-quipago) has been installed.
    - Minor refactoring


  • Compatible with Open Source (CE) : 2.0 2.1
  • Stability: Stable Build
  • Description:

    Minor bug fixes


Back to top
The best place to start if you need help with a specific extension is to contact the developer. All Magento developers have both a contact email and a support email listed.

Q & A

Back to top


Back to top