Developers

Fast Track Onboarding Developer Guide

Contents

Your journey starts with receiving an email with an activation link for your sandbox account.

You need to click on the activation link and set a new password. Your login username, which is automatically generated, is included in the email.

 

Getting Started Page in Sandbox

Once you log in for the first time to the sandbox, you are directed to the Get Started page.

The Get Started page outlines the steps you must take to complete the integration process and go live.


Step 1: Choosing your Integration

Here you can explore the two main solutions of integration: Checkout Page and Web SDK.

These are just a demo of our products. Go to our Payment Overview to find our complete guide on how to implement the relevant code in your system.

In addition, guides for test cards (non-3D-Secure, 3D-Secure v1, and 3D-Secure v2) and flows can be found here.

Checkout Page

We have prepared a page to explore and on which to run test transactions and make minor customizations.

We also added a checksum calculator tool to create and build checkout page requests. This will help you understand how a request is made.

For more information, see our Checkout Page guide.

Web SDK

Here you can see a demo of our SDK solution and how it works. To implement it, you need to follow our Web SDK guide where you can find information on how to implement the SDK in a few easy steps.

Click the Go to SDK button to open the SDK Playground:

You can use the SDK Playground to experience the different SDK solution.

Step 2: Customizing DMNs and Redirect URLs

In this section you will find your sandbox processing credentials: (siteid, MerchantID, secretkey).

For security reasons, the secret key is sent separately when you click the Send me the secret button.

You will need to set the URL on which you would like to receive the Direct Merchant Notifications (DMNs). For more information, see our guide on DMNs.

In addition, you can set the Redirect URLs. Those are the URLs of the landing pages for a successful transaction, a failed transaction, or an error.

There are also other settings related to the payment page that you can configure here.

Step 3: Certifying your Integration

Once you have integrated the option you chose in Choosing an Integration and configured the settings in Customizing DMNs and Redirect URLs according to your preference, you can continue to self-certify your integration.

You need to choose the integration type you used – Checkout or Web SDK – and start the certification session via the start button:

You now have 30 days to perform all the mandatory tests.

Once all the mandatory tests are performed, self-certification is considered successful, and Nuvei prepares your production account. You will receive an activation email with a username for your production account.

Step 4: Your Production Account is Created

After you successfully complete the self-certification of your integration, we will open a production account for you. You will again receive an email with an activation link and a password to continue setting up your production account. Please access your temporary Control Panel production account by clicking the provided link or copying and pasting it into your browser.

The production account is opened with processing status Disabled. This means the account cannot yet process live transactions until all the commercial aspects are completed successfully.

Getting Started on Production

Once you receive the activation email and you set your password, you can log in to the production Control Panel.

You must perform the following two actions:

Retrieve your live processing credentials (siteid, MerchantID, secretkey) so that you can configure them in your integration.

Configure different URLs (live) for the DMN notification that are different than the one you used on your sandbox environment.

Most merchants are not required to pass the self-certification process with their production account, but it might be required. Please remember that testing can only be performed in your Nuvei Sandbox Environment.

Account Opening + Live Processing

Once the commercial aspects are completed successfully, you will receive the official account opening email from Nuvei, which notifies you that you can start live processing.

Until then, your live production account remains closed and no live transactions are allowed. Once you are notified that your account is activated, it is recommended that you start with a few live test transactions and monitor the live traffic activity closely.

For further information, please contact your account manager or salesperson.

For any technical questions you may have, please contact the Nuvei Integration Team with your Ref ID from the prod activation email, or via the Contact Support option in our back office tool (the CPanel) to which you just received access.