Nuvei Payment Gateway
RestroPress Nuvei Payment Gateway adds Nuvei as a checkout option. The customer is redirected to a Nuvei payment page and returned to your site afterwards. It is a small first version of about 280 lines of code with limited order handling.
Requirements#
- RestroPress (no minimum version is declared).
- A Nuvei merchant account with a Merchant ID, an API Key and a Signature Key.
Installation#
- Go to Plugins › Add New › Upload Plugin, upload the ZIP, install and activate.
- Go to RestroPress › Settings › Payment Gateways, enable Nuvei and save.
- Open the Nuvei section and enter your credentials.
There is no licence key field in this plugin.

Settings#
Found under RestroPress › Settings › Payment Gateways › Nuvei.
| Setting | What it does | Default |
|---|---|---|
| Merchant ID | Your Nuvei Merchant ID. The same value is also sent as the merchant site ID. | Empty |
| API Key | Your Nuvei API Key. It is required to be non-empty but is not sent to Nuvei by the code. | Empty |
| Signature Key | Used to build the SHA-256 checksum of the request. | Empty |
| Test Mode | Checkbox, "Enable test mode for Nuvei." When ticked, requests go to ppp-test.nuvei.com instead of secure.safecharge.com. | Unchecked |
If Merchant ID, API Key or Signature Key is empty, checkout shows "Nuvei configuration is incomplete."
How it works#
- The customer picks Nuvei. No card form is shown.
- On placing the order, RestroPress creates a pending order and the plugin sends a Nuvei payment page request (transaction type Sale) with the order number as
clientRequestId, the total, the currency and a checksum. - The customer is redirected to the
redirectUrlNuvei returns. Success and pending URLs point to?rpress-listener=nuveion your site; the failure URL is your checkout page. - When that listener URL is opened with a
clientRequestId, the plugin sets that order to complete, empties the cart and redirects to the success page.
This early version does not yet confirm payments with the provider, so do not use it for live payments. Treat the extension as incomplete and test thoroughly before use. Refunds are not implemented.
Troubleshooting#
- "Payment gateway error." at checkout: Nuvei did not return a
redirectUrl. WithWP_DEBUGon, the response is written to the PHP error log with the prefix[RPRESS Nuvei]. - "Invalid response from Nuvei": the return request had no
clientRequestId. - "Payment not found":
clientRequestIddid not match an order.
Changelog highlights#
The readme lists 1.0.0 as the initial release.
Was this page helpful?
