Do you already have an integration with one of the bellow plugins? Please click on it to learn more about how to configure your module and to sign-up with us.
Smart2Pay offers 3 environments that you can use to interact with our payment platform.
Demo – you should start in Demo environment where all the available payment methods are activated by default and you can use to test our plugin right away. No activation is required. You can test various payment flows for more than 150 payment methods. The order status does not update in this environment, you need to use Test and Live environments for an end to end testing.
Test – Once you are familiar with payment flows you should start the integration and testing phase using the test platform https://dashboardtest.smart2pay.com. You will receive an e-mail from our merchant integration team with more details such as your test MID and instructions on how to generate the test signature and setup the notification URL where you will receive payment status change notifications so your orders are correctly updated once the payment flows are completed.
Live – As soon as the development and testing phase are successfully completed you will need to follow the same steps for integration on the live platform: https://globaldashboard.smart2pay.com.
You can always contact our Merchant Integration Team to request additional information about our services at: technicalsupport-s2p@nuvei.com.
Nuvei Magento Plugin
Nuvei Magento Plugin: connects your Magento store to GlobalPay, the latest payment platform of Smart2Pay. Below you will find the necessary details for Magento websites administrators on how to install and configure the plugin on your Magento store.
Magento Plugin Version and Compatibility List
Smart2Pay plugin is compatible with the following Magento versions:
Compatible with Open Source (CE) : 2.3;
Compatible with Commerce on prem (EE) : 2.2 2.3;
Compatible with Commerce on Cloud (ECE) : 2.2 2.31.1.16b.
Nuvei Magento Plugin Installation
Thank you for choosing Nuvei extension for your Magento® store. The steps necessary for installing the Magento® 2 Plugin are described next. You can download the archive from GitHub.
Install the plugin using Composer:
Run the following composer command in the root of magento from your ssh console: composer require smart2pay/magento2;
Enable the extension in the command line in the root of Magento by executing bin/magento module: enable Smart2Pay_GlobalPay;
Update Magento to execute the install and update scripts in the command line in the root of magento by executing:
bin/magento setup:upgrade
bin/magento setup:di:compile;
In your Magento backend, go to System > Cache Management and click the Flush Cache Storage button;
It is recommended to log out, and log in again if you are already logged in to your Magento backend.
Nuvei Magento Plugin Configuration
The configurations for the Nuvei Magento plugin can be found in the administration area of Magento under ‘Stores’ -> ‘Configuration’ -> ‘Sales’ -> ‘Payment Methods’ -> ‘Smart2Pay.
Note: If the Nuvei Payment Module is not visible, please make sure that the module output is enabled from: ‘System‘ -> ‘Web Setup Wizard‘ -> ‘Module Manager‘.
Checkout below the available options of configuration for the Nuvei Magento plugin:
Nuvei Payment Module Configuration
General Settings
Field
Description
Type
Sample
Enabled
Defines whether the Nuvei payment module is active or not. If it is active it will appear in the list of payment methods.
Boolean
Yes
Method Title
You can insert a custom title for the payment module. This will be displayed to the customers in the checkout process when selecting from possible payment methods.
String
Nuvei Methods
Environment
The environment to which the plugin points to. If Test is selected then the Return URL and API Key (Test) will be used when making the payment. If Demo environment is selected, shop will create transactions on a predefined SiteID and API Key combination, just so that you can see an end-to-end transaction flow. This will not require any registration on your behalf on our test or live platforms. However, keep in mind that your shop will not receive background notifications about order updates so not all details and functionality for an order will be available / visible.
[Test, Demo, Live]
Test
Site ID (TEST)
If you are managing multiple stores you can use a separate SiteID for each website, with different Signature, ReturnURL and NotificationURL. Please contact technicalsupport-s2p@nuvei.com for more details on how to setup a multistore configuration.
Integer
69947
API Key (TEST)
The secret authentication token used for communicating with our system. You can regenerate your API KEY for test environment at: https://dashboardtest.smart2pay.com.
If you are managing multiple stores you can use a separate SiteID for each website, with different Signature, ReturnURL and NotificationURL. Please contact technicalsupport-s2p@nuvei.com for more details on how to setup a multistore configuration.
Integer
0
API Key (Live)
The secret authentication token used for communicating with our system for live environment. You can set up your API Key for production environment at: https://globaldashboard.smart2pay.com at Configuration Tab -> REST API -> Generate new API key.
String
–
Return URL
An URL where the customer will be redirected after the payment process ends. It is advisable to include the path to the smart2pay/feedback action which displays a friendly message to the user depending on the redirection status of the transaction. This field is filled automatically by plugin at install time. If, however, this URL doesn’t work for you, you can manually correct it in a similar way which is presented in Sample column.
String
http://www.yoursite.com/smart2pay/payment/finish/
Skin ID
Specify the skin ID. The skins can be created in the Online Skin Editor available in the Merchant Dashboard or by uploading a CSS file.
Integer
0
Sort order
Sort order will change order of all Nuvei payment methods.
Integer
0
Methods Display Settings
Field
Description
Type
Sample
Methods display mode
By default, method icon images will be shown (Logo and Text). You have the option to display the payment methods as text or as logo and text.
List
Text
Display method description
By default, methods will be displayed having payment method’s logo and description. When set to no, description will not be displayed.
Boolean
No
Send order number as product description
If set to ‘Yes’, the Magento order number will be sent as description. If ‘No’ is selected, the below custom description will be sent.
Boolean
Yes
Custom product description
Specifies a global description that will be sent for all the transactions.
String
Custom product description
Email Settings
Field
Description
Type
Sample
Notify customer by email
If set to ‘Yes’, the system automatically sends a confirmation email to the customer on success payment notification.
Boolean
Yes
Payment Confirmation Template
The template of the e-mail
List
Payment Confirmation
Send payment instructions on order creation
For Bank Transfer and Multibanco SIBS, Magento can send a confirmation email to the customer on order creation with payment details.
The template of the e-mail containing payment instructions for Multibanco SIBS (PT) payment method.
List
Payment Instructions (SIBS)
Payment Instructions Template (for Bank Transfer)
The template of the e-mail containing payment instructions for Bank Transfer payment method.
List
Payment Instructions (Bank Transfer)
Order Related Settings
Field
Description
Type
Sample
Create invoice on success
If set to ‘Yes’, the system automatically creates an invoice if payment is successfully completed. The invoice is automatically set to ‘paid’.
Boolean
Yes
Use 3D Secure
Protocol designed to be an additional security layer for online credit and debit card transactions. It should be set on true for Payments using 3DSecure authentication.
Boolean
Yes
New Order status
The status of the order after creation.
List
Pending
Order status on SUCCESS
You should only deliver the goods/services based on the Success notifications. The notifications are received at the notification URL which you set up in the GlobalPay merchant dashboard available at: https://dashboardtest.smart2pay.com. You should only deliver the goods/services based on the Success notifications. The notifications are received at the notification URL which you set up in the GlobalPay merchant dashboard available at: https://dashboardtest.smart2pay.com. The notification URL is in the form: http://www.merchant.com/index.php/globalpay/index/handleResponse. Magento Smart2Pay_GlobalPay Plugin automatically updates the order status according to the received notifications. This configuration defines the status of the order when the payment has been successfully completed and a ‘success’ notification is sent by the GlobalPay system. You can release the goods/services in this case.
List
Processing
Order status on CANCEL
The status of the order when a ‘canceled’ notification is sent by GlobalPay system.
List
Canceled
Order status on FAIL
The status of the order when a ‘failed’ notification is sent by GlobalPay system.
List
Failed
Order status on EXPIRED
The status of the order when an ‘expired’ notification is sent by GlobalPay system.
List
Expired
Payment Flow Settings
Field
Description
Type
Sample
Message Success
The message that is displayed at the end of the payment flow when the redirection status is a success. You should only deliver the goods/services based on the success notification received at the notification URL which you set up in the GlobalPay merchant dashboard available at: https://dashboardtest.smart2pay.com. The notification URL is in the form: http://www.merchant.com/index.php/globalpay/index/handleResponse.
String
Thank you, the transaction has been processed successfully. After we receive the final confirmation, we will release the goods.
Message Failed
The message that is displayed at the end of the payment flow when the customer is redirected with a failed status.
String
There was a problem processing your payment. Please try again.
Message Canceled
The message that is displayed at the end of the payment flow when the customer has canceled the payment.
String
You have canceled the payment.
Message Pending
The message that is displayed to the customer when the redirection status is unknown or the customer must take additional actions to complete the payment: e.g. go to the bank and make an offline bank transfer.
String
Thank you, the transaction is pending. After we receive the final confirmation, we will release the goods.
After the main configuration of the Nuvei Payment Module, please activate the payment methods that you plan to use.
Nuvei Magento Payment Flow
The customer adds the product in the shopping cart and Proceeds to checkout.
In the Shipping area the customer needs to enter a valid email address that will be used for order confirmation. Also, the customer needs to provide a delivery address. The mandatory fields are marked with an asterisk sign. The customer can create an account after the checkout.
After choosing a delivery address, the customer has to select a shipping method.
Depending on the billing country of the customer, the activated methods are shown in the checkout process in the Payment step, Nuvei Methods section. After choosing the payment method, the customer can click Place the Order button.
After selecting the preferred payment method the customer needs to confirm the order by clicking on the Place the Order button.
After order confirmation the customer is redirected to the chosen payment method provider where he enters the necessary details of the payment.
The customer is redirected to the provider’s confirmation page where he needs to click on the Confirm payment button.
Upon completion of the payment flow, the customer is redirected back to your website.
Magento Payment Status Notification
After receiving the final confirmation from the provider, our server notifies Magento about the status change. The plugin handles these notifications and updates the order accordingly. This can be found in the administration area of Magento under ‘Sales’ -> ‘Orders’ area.
Nuvei OpenCart Plugin
Nuvei OpenCart Plugin: connects your OpenCart store to GlobalPay, the latest payment platform of Smart2Pay. Below you will find the necessary details for OpenCart websites administrators on how to install and configure the plugin on your OpenCart store.
OpenCart Plugin Version and Compatibility List
Current stable plugin version of OpenCart is 1.0.11. Nuvei plugin is compatible with OpenCart version 2.0.
Nuvei OpenCart Plugin Installation
After downloading the archive from GitHub, you need to copy the contents of the archive in your OpenCart installation folder.
In order to install an OpenCart Extension you need to connect to your FTP server and locate your shop on your server. This will be the location in which you installed your store.
Locate the extension on your local machine that you wish to install and the folders to be uploaded.
Inside the designated upload folder you will find the folders that need to be uploaded to install the extension.
To install the extension, simply drag the designated folders into the empty space below the files on your server. The extension folder structure will put the extension files in the required locations. Make sure to drag the folders into an empty area below the files on your server to avoid uploading the files into a subfolder.
From OpenCart Back Office go to Extensions -> Modules -> Module List -> Module Name, where you can install the new plugin, as shown in the below picture.
Nuvei OpenCart Plugin Configuration
The configurations for the Nuvei OpenCart plugin can be found in the administration area of OpenCart under: Extensions -> Payments menu -> Payment Method section -> Nuvei Payment Module. Once you find the Nuvei plugin click on the Edit button and go to Module Settings, where you can edit the Nuvei plugin, as shown in the below picture.
Smart2Pay plugin contains the generic configurations that are necessary to connect your store with the payment platform. You will also need to install and activate the payment methods that you intend to use: e.g. Nuvei Paysafecard, Nuvei UKash, Nuvei iDEAL etc.
Please make sure that Nuvei module is enabled from Extensions -> Payments menu, Payment Method section -> Nuvei -> Edit (Enabled set to yes).
Checkout below the available options of configuration for the Nuvei OpenCart plugin:
Nuvei Payment Module Configuration
Field
Description
Type
Sample
Enabled
Defines whether the Nuvei payment module is active or not. If it is active it will appear in the payment method lists.
Boolean
Yes
Environment
The environment to which the plugin points to. If Demo is selected you don’t have to provide other MID or signature. If Test is selected then the Post URL Test, Signature Test and MID Test will be used when making the payment.
[Demo, Test, Live]
Test
Post URL Live
The URL of GlobalPay API live environment.
String
https://api.smart2pay.com
Post URL Test
The URL of GlobalPay API test integration environment.
String
https://apitest.smart2pay.com
Signature Live
The signature that will be used to compute the hash for live environment. You can set up your signature at: https://globaldashboard.smart2pay.com, Configuration Tab->Signature for live environment.
String
Fb4235ed-xxxx
Signature Test
The signature that will be used to compute the hash for live environment. You can set up your signature at: https://dashboardtest.smart2pay.com for test environment.
String
Fb4235ed-xxxx
MID Live
The Merchant ID for the live environment. Create an account from https://globaldashboard.smart2pay.com The account will be activated by Nuvei Operations Team and you will receive an e-mail containing the MID.
Integer
1045
MID Test
The Merchant ID for the test environment. Create an account from https://dashboardtest.smart2pay.com The account will be activated by Nuvei Operations Team and you will receive an e-mail containing the MID.
Integer
1045
SiteID
If you are handling multiple OpenCart websites and you want to use a single MerchantID for all of them, you need to configure multiple websites from GlobalPay Merchant Dashboard, Configuration tab.
Integer
40015
Skin ID
Specify the skin ID. The skins can be created in the Online Skin Editor available in the GlobalPay Merchant Dashboard or by uploading a CSS file.
Integer
6
Return URL
An URL where the customer will be redirected after the payment process ends. It is advisable to include the route payment/smart2pay/feedback action which displays a friendly message to the user depending on the redirection status of the transaction.
The available options are described in the following table:
Field
Description
Type
Sample
Send order number as product description
If set to ‘Yes’, the OpenCart order number will be sent as description. If ‘No’ is selected, the below custom description will be sent.
Boolean
No
Custom product description
Specifies a global description that will be sent for all the transactions.
String
Cinema ticket
Notify customer by email
If set to ‘Yes’, the system automatically sends a confirmation email to the customer on success payment notification.
Boolean
Yes
Make order visible
By default, orders are not visible in the orders list. You can control the moment when an order is confirmed and becomes visible by selecting one of the following options:
– When initiated: the order is confirmed and made visible when the customer initiates a payment via Smart2Pay.
– When redirecting to payment page: the order is confirmed and made visible when the customer returns to the ReturnURL.
– When receiving payment notification: the order is confirmed and made visible when the transaction has a final status from: success, failed, cancelled, expired.
– When transaction is paid: the order is confirmed and made visible only when the customer paid and the transaction is confirmed by the payment method provider.
Order status when NEW
The status of the order when a new order is created.
List
Pending
Order status when SUCCESS
You should only deliver the goods/services based on the success notifications. The notifications are received at the notification URL which you set up in the GlobalPay merchant dashboard available at: https://dashboardtest.smart2pay.com. The notification URL is in the form: http://www.merchant.com/index.php?route=payment/smart2pay/callback. OpenCart Nuvei GlobalPay Plugin automatically updates the order status according to the received notifications. This configuration defines the status of the order when the payment has been successfully completed and a ‘success’ notification is sent by GlobalPay system. You can release the goods/services in this case.
List
Processing
Order status when CANCEL
The status of the order when a ‘canceled’ notification is received from Smart2Pay’s GlobalPay system.
List
Canceled
Order status when FAIL
The status of the order when a ‘failed’ notification is received from Smart2Pay’s GlobalPay system.
List
Failed
Order status on EXPIRED
The status of the order when an ‘expired’ notification is received from Smart2Pay’s GlobalPay system.
List
Expired
Skip Payment Page
If set to ‘Yes’, if all the necessary parameters are sent in the initial POST for a specific payment method, the GlobalPay payment page is skipped and the customer is redirected automatically to the payment method provider.
Boolean
Yes
Redirect in Iframe
If set to ‘Yes’, GlobalPay will try to keep the payment flow inside the Iframe. Only some payment methods providers support Iframes, for the others the customer will be redirected to the provider in the main window.
Boolean
No
[Debug form]
For integration/debugging purposes only. If set to ‘Yes’, a form with the values sent in the initial POST to GlobalPay will be displayed prior to the actual POST.
Boolean
No
Sort Order
Sort order will change order of all Nuvei payment methods.
After saving the main configuration, please go to Payment Methods to activate the payment methods that you plan to use.
The following message will appear:
A list of all Nuvei payment methods will appear, making it easier for you to see all the payment methods. From here you can install and activate the payment method that you wish.
Nuvei OpenCart Payment Flow
After the customer adds the product in the shopping cart, he has two options: to Continue Shopping or to go to Checkout.
Depending if the customer is a New or a Returning Customer he has to create an account or only to provide an email and a password to complete the login/sign in process.
Depending on the billing country of the customer, the activated methods are shown in the checkout process in the Payment Method step.
After selecting the proper payment method the customer needs to confirm the order.
After order confirmation the customer is redirected to the chosen payment method provider where he finalizes the payment.
Upon completion of the payment flow, the customer is first redirected back to the Nuvei return page.
The flow is ended when the customer is redirected back to order confirmation page.
OpenCart Payment Status Notification
After receiving the final confirmation from the provider, our server notifies OpenCart about the status change. The plugin handles these notifications and updates the order accordingly. This can be checked in OpenCart backend in Sales -> Orders area -> Order List.
Nuvei Prestashop Plugin
Nuvei Prestashop Plugin: connects your Prestashop store to GlobalPay, the latest payment platform of Smart2Pay. Below you will find the necessary details for Prestashop websites administrators on how to install and configure the plugin on your Prestashop store.
Prestashop Plugin Version and Compatibility List
Current stable plugin version of Prestashop is 2.0.7 for Payment Module and 2.0.0 for Detection Module. Nuvei plugin is compatible with Prestashop versions 1.5, 1.6 and 1.7.
Nuvei Prestashop Plugin Installation
After downloading the archive from GitHub, you can install our plugin by following these steps:
From Prestashop Back Office go to Modules -> Module Manager, press UPLOAD A MODULE button from the top of the page and then select our archived module, as showed in the below picture.
Copy the contents of the archive in your Prestashop Modules folder.
Nuvei Prestashop Plugin Configuration
The configurations for the Nuvei Prestashop plugin can be found in the administration area of Prestashop under: Modules -> Modules Manager -> Modules -> Others. A list of all the installed plugins will appear. Select the Nuvei plugin and proceed to configure it by using the Configure button.
Nuvei module contains the generic configurations that are necessary to connect your store with the payment platform. You will also need to activate the payment methods that you intend to use: e.g. Bank Transfer, CashU, SOFORT Banking etc.
Nuvei Payment Module Configuration
Checkout below the available options of configuration for the Nuvei Prestashop module:
Field
Description
Type
Sample
Enabled
Defines whether the Nuvei payment module is active or not. If it is active it will appear in the payment method lists.
Boolean
Yes
Environment
The environment to which the module points to. If Test is selected, then the Site ID Test and APIKey Test will be used when making the payment. If Demo environment is selected, shop will create transactions on a predefined SiteID and APIKey combination, just so that you can see an end-to-end transaction flow. This will not require any registration on your behalf on our test or live platforms. However, keep in mind that your shop will not receive background notifications about order updates so not all details and functionality for an order will be available / visible.
[Demo, Test, Live]
Demo
Site ID Live
The ID of the Site used for the Live Environment. If you are handling multiple Prestashop websites and you want to use a single MerchantID for all of them, you need to configure multiple websites from GlobalPay Merchant Dashboard, Configuration tab.
Integer
0
APIKey Live
The APIKey for the Live environment. Please make sure the API keys are kept secret and regenerate at once if security has been compromised!
Integer
0
Site ID Test
The ID of the Site used for the Test Environment. If you are handling multiple Prestashop websites and you want to use a single MerchantID for all of them, you need to configure multiple websites from GlobalPay Merchant Dashboard, Configuration tab.
Specify the skin ID. The skins can be created in the Online Skin Editor available in the GlobalPay Merchant Dashboard or by uploading a CSS file.
Integer
0
Return URL
An URL where the customer will be redirected after the payment process ends. It is advisable to include the route smart2pay/feedback action which displays a friendly message to the user depending on the redirection status of the transaction. This field is filled automatically by plugin at install time. If however, this URL doesn’t work for you, you can manually correct it in a similar way which is presented in Sample column.
If this option is selected Country detection will be disregarded.
NOTE: Please make sure that all of your clients can make payments in the selected country.
List
Don’t force country
Field
Description
Type
Sample
Country detection
The plugin will try detecting visitor’s country by IP. The country is very important as payment methods are displayed depending on the country. Country detection is available when you install and activate Nuvei Detection plugin. If you select ‘Yes’ and the country detection plugin is not installed, the plugin will use the fallback country set in customer’s billing address.
Boolean
Yes
Use IP sent by proxy
If your site is behind a firewall IP in headers might be set for every request to firewall IP.
If HTTP_CLIENT_IP or HTTP_X_FORWARDED_FOR header is set by firewall to the actual IP of customer, this option tells the plugin to first check if such variables are set in headers and if set use that as customer IP. The plugin will first check if HTTP_CLIENT_IP is a valid IP, then HTTP_X_FORWARDED_FOR.
Boolean
No
Fallback country
If the country detection fails or set to ‘No’, the module will use the country set in this field (by default will be: country set in billing address).
List
Country From Billing Address
Send order number as product description
If set to ‘Yes’, the Prestashop order number will be sent as description.
If ‘No’ is selected, the below custom description will be sent.
Boolean
Yes
Custom product description
Specifies a global description that will be sent for all the transactions.
String
Custom product description
Create invoice on success
If set to ‘Yes’, the system automatically creates an invoice if payment is successfully completed. The invoice is automatically set to ‘paid’.
Boolean
Yes
Notify customer by email
If set to ‘Yes’, the system automatically sends a confirmation email to the customer on success payment notification.
Boolean
Yes
Send payment instructions on order creation
Some payment methods (like Bank Transfer and Multibanco SIBS) generate information necessary for customer to complete the payment. This information is displayed to the customer on the return page, but the plugin can also send an email to customer with these details.
Boolean
Yes
Alter order total based on surcharge
When using a payment method which has a surcharge amount or percent set, order total will be incremented with resulting surcharge amount.
Boolean
Yes
Field
Description
Type
Sample
Surcharge will use currency (display only)
When displaying surcharge amount in checkout flow, it will use currency that is: setup in front-end or used in payment method setup
List
Setup in front-end
Surcharge display amount
The display of the surcharge amount in the checkout flow as: separated percent and fixed amount, as sum of percent and fixed amount or as total amount for the order.
List
Separated percent and fixed amount
New Order Status
The status of the order when a new order is created.
List
Nuvei – Awaiting payment
Order status on SUCCESS
You should only deliver the goods/services based on the success notifications. The notifications are received at the notification URL which you set up in the GlobalPay merchant dashboard available at: https://dashboardtest.smart2pay.com. The notification URL is in the form: http://iasi.smart2pay.com:7020/prestashop1706/module/smart2pay/replyHandler. Nuvei Prestashop Plugin automatically updates the order status according to the received notifications. This configuration defines the status of the order when the payment has been successfully completed and a ‘success’ notification is sent by GlobalPay system. You can release the goods/services in this case.
List
Nuvei – Awaiting payment
Order status on CANCEL
The status of the order when a ‘canceled’ notification is received from Smart2Pay’s GlobalPay system.
List
Nuvei – Canceled payment
Order status on FAIL
The status of the order when a ‘failed’ notification is received from Smart2Pay’s GlobalPay system.
List
Nuvei – Failed payment
Order status on EXPIRED
The status of the order when an ‘expired’ notification is received from Smart2Pay’s GlobalPay system.
List
Nuvei – Expired payment
Message Success
The message that is displayed at the end of the payment flow when the redirection status is a success. You should only deliver the goods/services based on the success notification received at the notification URL which you set up in the GlobalPay merchant dashboard available at: https://dashboardtest.smart2pay.com. The notification URL is in the form: http://iasi.smart2pay.com:7020/prestashop1706/module/smart2pay/replyHandler.
String
Thank you, the transaction was processed successfully. After we receive the final confirmation, we will release the goods.
Message Failed
The message that is displayed at the end of the payment flow when the customer is redirected with a failed status.
String
There was a problem processing your payment. Please try again.
Message Canceled
The message that is displayed at the end of the payment flow when the customer has canceled the payment.
String
You canceled the payment.
Message Pending
The message that is displayed to the customer when the redirection status is unknown or the customer must take additional actions to complete the payment: e.g. go to the bank and make an offline bank transfer.
String
Thank you, the transaction is pending. After we receive the final confirmation, we will release the goods.
Skip payment page
If set to ‘Yes’, if all the necessary parameters are sent in the initial POST for a specific payment method, the GlobalPay payment page is skipped and the customer is redirected automatically to the payment method provider.
Boolean
No
Redirect in IFrame
If set to ‘Yes’, GlobalPay will try to keep the payment flow inside the IFrame. Only some payment methods providers support IFrames, for the others the customer will be redirected to the provider in the main window.
Boolean
No
After saving the main configuration of the module, please activate the payment methods that you plan to use.
Surcharge: Some payment methods may have a surcharge, meaning an extra fee added to the regular cost. The surcharge amount is provided in shop’s default currency.
Priority: If you want to prioritize payment methods when displaying them at checkout, use Priority column. Lower values will display payment method higher on the page.
You can select the countries for which the method is active using the Customize countries button.
Press the Update method button so that the updated list of countries to appear. The countries for which the method is active will have a check mark.
Changes are saved when you submit the form using the button Update payment methods which is under the table of methods.
A confirmation message will appear on top of the Configure Nuvei module page.
Nuvei Prestashop Payment Flow
The customer adds the product in the shopping cart and Proceeds to checkout.
The new customer has to enter his personal information, like First Name, Last Name and his Email Address. He also has the possibility to create an account in order to save time on his next order. He will need to provide a password and his birthdate.
The customer needs to enter the addresses that will be used as his personal address (for invoice) and as his delivery address.
After choosing a delivery address, the customer has to select a shipping method.
During the checkout process, the customers see the activated payment methods, depending on country detection settings of Nuvei plugin (forced country, country detected by IP or fallback country). The customer needs to select the preferred payment method and he also needs to agree to the term of service.
After selecting the preferred payment method from the list, the customer is redirected to the chosen payment method provider where he finalizes the payment.
Upon completion of the payment flow, the customer is redirected back to your website.
Prestashop Payment Status Notification
After receiving the final confirmation from the provider, our server notifies Prestashop about the status change. The plugin handles these notifications and updates the order accordingly. This can be checked in Prestashop backend in the Sell area -> Orders.
Nuvei WooCommerce Plugin
Nuvei WooCommerce Plugin connects your WooCommerce store to GlobalPay, the latest payment platform of Smart2Pay. Below you will find the necessary details for WooCommerce websites administrators on how to install and configure the plugin on your WooCommerce store.
WooCommerce Plugin Version and Compatibility List
Current stable plugin version of WooCommerce is 1.2.5. Nuvei plugin is compatible with WooCommerce version 3.5.4 + and with WordPress version 5.0.3 +.
Nuvei WooCommerce Plugin Installation
The installation process of the Nuvei Plugin requires first downloading the WordPress platform, WooCommerce plugin, and then uploading the Nuvei WooCommerce plugin and installing Nuvei PHP-SDK.
In order to download the WordPress platform, please go to the download page of https://wordpress.org/download/ and follow the installation instructions.
In order to install Nuvei WooCommerce plugin, you need to follow the next steps:
Download the archive from GitHub in your installation folder.
Please note: Upon download, the system will rename the directory into woocommerce-master. You will have to change the name of the directory into the correct form woocommerce-smart2pay.
Upload woocommerce-smart2pay directory to the plugins directory from your WordPress dashboard.
Go to Plugins setting page and activate WooCommerce Nuvei.
From your WordPress dashboard go to WooCommerce area -> Settings -> Checkout section and navigate to Payment Gateways area where Nuvei – alternative payment methods option should be available and click Enable button.
Click the Save Changes button to complete the installation of the WooCommerce plugin.
Nuvei WooCommerce Plugin Configuration
The configurations for the Nuvei WooCommerce plugin can be found in the WordPress dashboard under WooCommerce area: Settings -> Checkout -> Nuvei.
Smart2Pay plugin contains the generic configurations that are necessary to connect your store with the payment platform. You will also need to install and activate the payment methods that you intend to use: e.g. Nuvei Paysafecard, Nuvei UKash, Nuvei iDEAL etc.
If the Nuvei payment module is not visible, please make sure that Nuvei module is activated from Plugins -> Installed Plugins -> WooCommerce Nuvei -> Activate.
Checkout below the available options of configuration for the Nuvei WooCommerce plugin:
Nuvei Payment Module Configuration
Nuvei – General Settings
Field
Description
Type
Sample
Enabled
Defines whether the Nuvei payment module is active or not. If it is active it will appear in the payment method lists.
Boolean
Enable Nuvei payment gateway
Method Title
This will be displayed to the customers in the checkout process when selecting from possible payment methods
String
Nuvei – Alternative payment methods
Environment
The environment to which the plugin points to. If Demo is selected you don’t have to provide API Key, Site ID or Skin ID. If Test is selected then the TEST API Key, TEST Site ID and TEST Skin ID will be used when making the payment.
[Demo, Test, Live]
Test
TEST API Key
The API Key used to authenticate the requests for the test environment. To obtain your credentials for test environment, please contact us at technicalsupport-s2p@nuvei.com.
String
OjGm0QudKqUZqqfct3WN+hW+gUkgOixxxxxxxxx
LIVE API Key
The API Key used to authenticate the requests for the live environment. To obtain your credentials for live environment, please contact us at technicalsupport-s2p@nuvei.com.
String
TEST SiteID
The ID of the test website, a unique number that identifies the website. If you are handling multiple WooCommerce websites and want to use a single MerchantID for all of them, you need to configure multiple websites from GlobalPay Merchant Dashboard, configuration tab.
Integer
305xx
LIVE Site ID
The ID of the live website, a unique number that identifies the website. If you are handling multiple WooCommerce websites and want to use a single MerchantID for all of them, you need to configure multiple websites from GlobalPay Merchant Dashboard, Configuration tab.
Integer
0
TEST Skin ID
Specify the skin ID for the test environment. The skins can be created in the Online Skin Editor available in the GlobalPay Merchant Dashboard or by uploading a CSS file.
Integer
0
LIVE Skin ID
Specify the skin ID for the live environment. The skins can be created in the Online Skin Editor available in the GlobalPay Merchant Dashboard or by uploading a CSS file.
Integer
0
Return URL
An URL where the customer will be redirected after the payment process ends. Please set Notification URL in Nuvei Dashboard to: http://s2pubuntu.cloudapp.net/woo/?wc-api=WC_Gateway_Smart2Pay.
The display of the surcharge amount in the checkout flow as separated percent and fixed amount.
Boolean
Display surcharge amounts to client?
Methods display mode
By default, method icon images and text will be shown (Both). You have the option to display the payment methods as only logo, method name or both.
List
Both
Show methods in grid
By default, methods will be displayed as a two columns table, having payment method’s logo or name and description. When checked, description is omitted, and columns number can be specified bellow.
Boolean
Show methods in grid
Grid column number
The number of columns for the grid with logos. Has effect only if Show methods in grid is marked. If left blank, the default value is 3 (This value is used only if above option is checked).
Integer
2
Send order number as product description
If checked, the WooCommerce order number will be sent as description. If not checked, system will send below custom description.
Boolean
Send order number as product description
Custom product description
Specifies a global description that will be sent for all the transactions.
String
Nuvei – Order Related Settings
Field
Description
Type
Sample
New order status
Status of the order right before redirecting to payment page.
List
On Hold
Order status when NEW
The status of the order when a new order is created.
List
Pending
Order status when SUCCESS
You should only deliver the goods/services based on the success notifications. The notifications are received at the notification URL which you set up in the GlobalPay merchant dashboard available at: https://dashboardtest.smart2pay.com. The notification URL is in the form: http://www.merchant.com/index.php?route=payment/smart2pay/callback. WooCommerce Nuvei GlobalPay Plugin automatically updates the order status according to the received notifications.
This configuration defines the status of the order when the payment has been successfully completed and a ‘success’ notification is sent by GlobalPay system. You can release the goods/services in this case.
List
Processing
Order status when CANCEL
The status of the order when a ‘canceled’ notification is received from Smart2Pay’s GlobalPay system.
List
Canceled
Order status when FAIL
The status of the order when a ‘failed’ notification is received from Smart2Pay’s GlobalPay system.
List
Failed
Order status on EXPIRED
The status of the order when an ‘expired’ notification is received from Smart2Pay’s GlobalPay system.
List
Cancelled
Nuvei – Payment Flow Settings
Field
Description
Type
Sample
Success message
The message that is displayed at the end of the payment flow when the redirection status is a success. You should only deliver the goods/services based on the success notification received at the notification URL which you set up in the GlobalPay merchant dashboard available at: https://dashboardtest.smart2pay.com. The notification URL is in the form: http://www.merchant.com/index.php/globalpay/index/handleResponse.
String
Thank you, the transaction has been processed successfully. After we receive the final confirmation, we will release the goods.
Failed message
The message that is displayed at the end of the payment flow when the customer is redirected with a failed status.
String
There was a problem processing your payment. Please try again.
Cancelled message
The message that is displayed at the end of the payment flow when the customer has canceled the payment.
String
You have canceled the payment.
Pending message
The message that is displayed to the customer when the redirection status is unknown or the customer must take additional actions to complete the payment: e.g. go to the bank and make an offline bank transfer.
String
Thank you, the transaction is pending. After we receive the final confirmation, we will release the goods.
After the main configuration of the Nuvei Payment Module, please activate the payment methods that you plan to use.
Note: Surcharges will be calculated from cart subtotal + shipping price. Additional taxes and fees will not be included in surcharge calculation.
Nuvei WooCommerce Payment Flow
The customer adds the product in the shopping. Cart. He has to options: to continue shopping or view cart.
In the shopping cart the customer can see the added products and the details of the payment.
The customer needs to enter the billing details, including customer and billing address to complete the sign in process. Next to the billing details the customer can see the details of the order.
Depending on the billing country of the customer, the activated methods are shown in the checkout process in the Nuvei – Alternative payment methods step.
After selecting the preferred payment method the customer needs to confirm the order by clicking on the Place Order button.
After order confirmation the customer is redirected to the chosen payment method provider where he enters the necessary details of the payment.
Upon completion of the payment flow, the customer is redirected back to the payment return page.
WooCommerce Payment Status Notification
After receiving the final confirmation from the provider, our server notifies WooCommerce about the status change. The plugin handles these notifications and updates the order accordingly. This can be checked in WordPress Dashboard in WooCommerce area -> Orders.
from the top of the page and then select our archived module, as showed in the below picture.
