Skip to content
Docs
Get RestroPress

Nuvei Payment Gateway

Updated 2 min read
On this page

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#

  1. Go to Plugins › Add New › Upload Plugin, upload the ZIP, install and activate.
  2. Go to RestroPress › Settings › Payment Gateways, enable Nuvei and save.
  3. Open the Nuvei section and enter your credentials.

There is no licence key field in this plugin.

The Nuvei section of the payment gateway settings

Settings#

Found under RestroPress › Settings › Payment Gateways › Nuvei.

SettingWhat it doesDefault
Merchant IDYour Nuvei Merchant ID. The same value is also sent as the merchant site ID.Empty
API KeyYour Nuvei API Key. It is required to be non-empty but is not sent to Nuvei by the code.Empty
Signature KeyUsed to build the SHA-256 checksum of the request.Empty
Test ModeCheckbox, "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#

  1. The customer picks Nuvei. No card form is shown.
  2. 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.
  3. The customer is redirected to the redirectUrl Nuvei returns. Success and pending URLs point to ?rpress-listener=nuvei on your site; the failure URL is your checkout page.
  4. 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. With WP_DEBUG on, 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": clientRequestId did not match an order.

Changelog highlights#

The readme lists 1.0.0 as the initial release.

Was this page helpful?