Overview

Nuvei provides workflows that you can run in Postman to get first-hand experience of how our server-to-server REST API 2.0 integration method works. Before developing and testing your own workflows using our REST 2.0 APIs, we recommend running these sample Postman workflows in our sandbox environment to understand their business principles.

We have created a JSON collection supporting a number of 3DS and non-3DS scenarios that you can import into Postman and try for yourself:
Nuvei REST API 2.0 collection.json

Getting Started

To get started, follow these steps:

1. Import the REST 2.0 Sandbox Environment
2. Configure the Environment Variables
3. Import the REST 2.0 JSON Collection
4. Start Running Requests

1. Import the Nuvei REST API 2.0 Sandbox Environment

To import the REST 2.0 sandbox environment:

1. Open Postman.
2. Open My Workspace or create a workspace.
3. Press Import.
   
4. Paste the following URL:
   https://docs.nuvei.com/wp-content/uploads/2025/02/Nuvei-REST-API-2.0-sandbox-environment.json
   As soon as you paste the URL, Postman imports the environment.
5. In the list of environments, select rest2 Sandbox – updated:
   

2. Configure the Environment Variables

When you use Postman to test APIs, you can configure environment variables, so that you do not have to manually configure them for each request.

To configure the REST 2.0 sandbox environment variables:

1. In My Workspace or the relevant workspace, open the Environments tab.
2. Select rest2 Sandbox – updated.
   
3. Provide current values for variables such as:
   • notificationUrl
   • buyerId
   • processingEntityId

   When you test the APIs, Postman references the current values.

4. Save the changes.

3. Import the Nuvei REST API 2.0 Collection

To import the REST 2.0 JSON collection:

1. Press Import.
2. Paste the following URL:
   https://docs.nuvei.com/wp-content/uploads/2025/02/Nuvei-REST-API-2.0-collection.json
   As soon as you paste the URL, Postman imports the environment, which appears in Postman as REST 2.0 collection for merchants sandbox.

4. Start Running Requests

1. In Environments, select REST 2.0 collection for merchants sandbox.
2. Select a flow and a method; for example, ThreeD Flow > Frictionless flow > POST /payments.
3. If relevant, modify values in the request with variable placeholders so that Postman references the current value of the environment variable.
   For example, in the body of the /payments request, to use the current value of the processingEntityId environment variable, make sure that processingEntityId: “{{processingEntityId}}“.

   {
     ...
     "processingEntityId": "{{processingEntityId}}"
     ...
   }

Documentation

Documentation for the Nuvei REST API 2.0 JSON collection is available in Postman:
Documentation is also available in the API Reference 2.0 guide.