Nexi XPay Greece.Documentation.

Nexi XPay Greece for VirtueMart connects a VirtueMart checkout to the Nexi XPay Greece Hosted Payment Page. Payment details are entered on the Nexi-hosted page, while the plugin creates the payment request, redirects the customer, verifies the authoritative result with Nexi and updates the VirtueMart order.

This documentation applies to version 1.0.0.

The plugin supports the Nexi XPay Greece Hosted Payment Page for:

• card payments;
• card installments based on configurable order-total tiers;
• IRIS, when enabled on the merchant terminal;
• Apple Pay, when enabled by Nexi and available on the customer’s device and browser;
• Google Pay, when enabled by Nexi and available on the customer’s device and browser;
• terminal-default accounting or explicit/manual capture;
• capture and full or partial refunds when Nexi exposes the corresponding action for the verified operation.

The plugin does not decide which alternative payment methods are enabled for a merchant. Availability on the Hosted Payment Page depends on the Nexi contract, terminal configuration, environment, customer device and browser.

Before installation, confirm the following:

1. Joomla 4 or Joomla 5 is installed and working.
2. VirtueMart is installed, configured and enabled. Tested with version 4.6.8.
3. PHP 7.4 or later is available.
4. The production shop uses a public HTTPS URL with a valid certificate.
5. The merchant has an active Nexi XPay Greece agreement and the correct API key for the selected TEST or LIVE environment.
6. IRIS, Apple Pay, Google Pay, installments and explicit accounting are enabled in the merchant’s Nexi agreement or terminal where those features are required.
7. The shop’s checkout, terms, privacy and cancellation/refund information meet the merchant agreement and applicable legal requirements.

1. Back up the Joomla files and database.
2. Sign in to the Joomla administrator area.
3. Open System → Install → Extensions.
4. Upload the versioned installable ZIP supplied by 2o2code. Do not extract the ZIP before uploading it through the Joomla installer.
5. Confirm that Joomla reports a successful installation.
6. Open System → Manage → Plugins.
7. Search for Nexi XPay Greece for VirtueMart.
8. Confirm that the plugin is enabled.
9. Activate the installation-wide software license before attempting a new Nexi payment.
10. Create and configure a VirtueMart payment method as described below.

Installing an update over an existing version preserves the plugin configuration and existing Nexi payment records. Always use Joomla’s installer or update system; do not replace plugin files manually.

License management is installation-wide. The license is configured once in the Joomla plugin settings and is not duplicated inside individual VirtueMart payment methods.

Activate the license

To activate the license:

1. Open System → Manage → Plugins.
2. Open Nexi XPay Greece for VirtueMart.
3. In License and updates, enter the software license key.
4. Select Activate license.
5. Confirm that the status becomes Active.
6. Confirm that Protected updates becomes Connected. A temporary “Token ready; update site pending” status means the license is active but Joomla has not yet completed the update-site connection.

License behavior

• Initial activation on the website is required before new Nexi payments can start.
• If the subscription expires, an already activated installation keeps processing payments. Updates and support end, and the license cannot be used for a new activation.
• If the license is deactivated locally, disconnected from the customer account or authoritatively revoked, new Nexi payments stop on that installation.
• Customer returns, notifications, Nexi verification, reconciliation, capture and refunds for transactions that already exist remain available regardless of the current license state.
• A temporary Freemius, DNS or network problem preserves the last successfully verified local entitlement. A transient outage does not deactivate an already verified installation.
• Protected downloads require a current update entitlement and fail closed when that entitlement cannot be confirmed.