Assumptions and Restrictions
Before proceeding to the Nuvei plugin installation, you need to have installed OpenCart. The module should be also installed and configured.
If you do not have test credentials to test the payment flow, please contact our Tech Support Team.
Supported Versions
Nuvei OpenCart plugin is tested on the following versions:
Oldest Supported Version | Last Tested Version | |
---|---|---|
OpenCart | 3.0.1.0 | 3.0.3.0 |
Installation
To install the Nuvei plugin using the native OpenCart plugin functionality:
- Press here to extract the OpenCart plugin (Version 3).
- Follow the instructions in the repo’s README.md file to install the relevant plugin.
If your modification file was installed, you see it in the Extensions > Modifications menu. Depending on your OC version, the menu may have a different name. - Here you can enable or disable the modifications. Press the Refresh button (blue button, top right) after each Enable or Disable action.
Plugin Configuration
Before setting up the Nuvei OpenCart plugin, you should contact Tech Support to provide account credentials.
To configure the Nuvei plugin:
- Navigate to Extensions > Select menu and select Payments (for OC 3.0.1.0 and up). For OC 2 the menu is Extensions > Payments.
- From the list of payment methods, find Nuvei and press the green Plus button to install the plugin.
After installing the plugin, the list looks like the image below:
- Press the blue Pencil button to edit the settings.
Field Name | Mandatory | Notes |
---|---|---|
Merchant ID | Yes | This is the merchant ID provided by Tech Support. If you don’t have it, please contact Tech Support. |
Merchant Site ID | Yes | This is the Merchant Site ID provided by Tech Support. If you don’t have it, please contact Tech Support. |
Merchant Secret Key | Yes | This is the secret key provided by Tech Support. If you don’t have it, please contact Tech Support. |
Merchant Hash type | Yes | The hash type provided by Tech Support. If you don’t have it, please contact Tech Support. |
Payment Action | Yes | Choose between a Sale and Auth flow. |
Sandbox mode | Yes | Enables the payment Sandbox mode. Any payments made in Sandbox mode are not actually processed. Please do not use real credit card details. |
Enable UPOs | Yes | Enable/disable the creation and usage of UPOs. |
Use HTTP Notify URL | Yes | If your site is on https server, but you cannot receive the DMS, force Notify URL to be http. |
Enable logs | Yes | Choose the type of the log. |
Total | No | The checkout total the order must reach before this payment method becomes active. |
Various "Status" fields | No | These fields allow the merchant to select the status they want to appear for each status. |
Geo Zone | No | Enables the plugin only for specific geographic zones. |
Status | No | Enable or disable the plugin. |
The default OC settings are not described in the table above.
Payment Page
- Select a product from your shop and go to the payment page.
- Follow the steps of checkout.
In the Payment Method step (its number can be different), select Nuvei and then press Continue.
In the Confirm Order step, you see the order details and Preferred Payment methods if you are using the REST API. In this case, a method must be selected and its fields filled. - Press the Confirm Order button.
Upon successful payment, the user is redirected to the merchant’s successful order page.
Order Payment Status Update
Order payment details are found in the Sales > Orders menu.
Press on any order. For each order processed with Nuvei, there are order trace notes to help track the payment process.
Once the order is saved and the user is redirected to the secured checkout page, the order status is set to “Pending Payment”.
After successful payment, the transaction is processed and the order status is updated in the background.
Order Details
Here and the logs (if they are enabled) are the two places where the merchant can see what happen with its order.
If the merchant flow is “Auth & Settle” (Transaction type option), all new orders have a status of “Pending payment”.
Under Items, you see the Settle button to settle an order.
OC v 2.0.1.0
OC v 3.0.3.0
If the merchant flow is “Sell” or the order was Settled, two buttons are available: Partial Refund and Void. With them you can request a refund or void your transaction once the order is completed. As you can see on the image below, you must enter the amount to refund.
When you press on either of these buttons, you must confirm your action. After the action is completed, a note with the information is created.
For the supported refund amount, please contact Tech Support.
When the refunded amount is equal to the total order amount, the Order status changes to “Refunded”. If you void your order, the status changes to “Canceled”.