Overview

To view the My Account page, select Settings > My Account on the main menu bar.

The My Account page contains four tabs:

Account Details
My Distributions
Events Configuration
Apple Pay Domain Verification

Account Details

On this tab, you can view your Merchant ID, Secret Key, and a table of Merchant Site IDs. In addition, you can toggle the IP Whitelist feature that enables you to grant Control Panel access to specific IP addresses.

The Secret Key can only be viewed by a user with Admin rights.

The Visibility column in the Merchant Site IDs table allows a merchant to select clients and/or sites to be invisible from the Client Name and Site Name dropdowns, respectively, in the relevant reports in case the clients and/or sites are irrelevant, inactive, and so on.

When you hide a client, all Site Names under that Client Name are no longer visible in the Site Name filter dropdowns.

My Distributions

The My Distribution tab displays the reports that were scheduled in the various searches and reports (see Scheduling a Query).

You can select an individual distribution and use the Actions dropdown to either:
- Run a previously scheduled report manually. Execute a previously scheduled report, without having to wait for the scheduled time. You can specify the date range for the report when running it manually. Once initiated, the report status will be marked as “pending,” and the user can expect to receive the results within the next hour, either via email or in the designated SFTP folder.
  
  Do not manually rerun the report if the action is still pending, as this may cause overlapping actions, duplicate runs, and unnecessary complications.
- Edit the selected distribution using the scheduling and/or editing interface(s).
- Delete the selected distribution(s).

Nuvei disables distributions for users who have not logged in for 60 days. A notification email is sent to such users 14 days before the distribution is disabled. The user must log in within these 14 days to keep the distribution active.

When the team management tries to deactivate a user who has saved queries (email/SFTP), the following notification appears:
“Warning! This user has active distributions for saved queries. When the user is deactivated, the distributions for saved queries will no longer be sent.”
*Relevant for active distributions only.

SFTP Folder Setup

In addition, beneath the My Distribution table, you can establish a connection to an SFTP folder.

This feature can only be viewed by a user with Admin rights.

To set up an SFTP folder:

[Optional] Enter a phone number.
Enter a valid non-business (private) email. The email you enter for the SFTP setup must be a different email than the merchant email used on your back-end registration.
Enter a valid IP address for the IP whitelist.
Press Send Request.

SFTP Notes:

Admin privilege is required to initially submit the SFTP creation form. Once the SFTP is established, users with the following roles can schedule a report: Management, Risk_Actions, Operations_Actions, and Finanace_Actions.
Before you can select the SFTP delivery type when scheduling a query, you must establish your SFTP connection here.
You should use a FTP program that allows secure file transfers from the Nuvei SFTP remote server to your destination.
Once the SFTP request is sent, it may take up to one day for the IP(s) to be added to the whitelist and configured on our systems. The Admin can then select the delivery type.
Any reports older than 15 days are deleted automatically from the SFTP folder.

Events Configuration

This tab can only be viewed by a user with Admin rights.

The Events Configuration tab allows merchants to configure Direct Merchant Notifications (DMNs), also known as a webhooks, for certain event types that may occur in your account. Webhooks are particularly useful for asynchronous events. Rather than requiring you to pull information via our API, webhooks push the information to your server side URL when important events occur.

You can create webhooks for the below event types:

To see an example structure for each of the event types, please press here.

Event Type	Description	Configuration Level
Pre-chargeback Alert	Notifies you that you received an Ethoca alert (Mastercard pre-chargeback), which may require a decision to be made by Nuvei's alerts case management, unless configured to be automatically refunded.	Client
Pre-chargeback Inquiry	Notifies you that you received an Order Insight inquiry (Visa pre-chargeback), which may have been automatically responded to by Nuvei on your behalf.	Client
Chargeback	Notifies you that you have either received a new chargeback, which requires your response, OR that a chargeback status has been updated following your response. Financial implications may be included depending on the chargeback status.	Client
Chargeback/Dispute	Notifies you that you have either received a new chargeback/dispute, which requires your response, OR that a chargeback/dispute status has been updated following your response. Financial implications may be included depending on the chargeback/dispute status.	Client
PayFac Submerchant Creation	Relevant only for payment facilitators, this notification acknowledges that a submerchant account was successfully created.	Multi-client
Manual Correction	Notifies you that transaction was manually corrected by the Nuvei Operation Team.	Client
Manual Inserted	Notifies you that transaction was manually inserted by the Nuvei Operation Team.	Client
Control Panel Generated Transaction	A transaction that is initiated and created directly by a user within the Nuvei Control Panel interface, rather than through an external integration, API call, or automated system. Notifies you that the new transaction was created manually in one of the following options (reports and actions): refund, void, settle, payout.	Client
Fraud Reported Transaction	Notifies you on transactions that have been reported as “Fraud” by issuer banks and are being considered when measuring your compliance with the card schemes’ fraud programs.	Client
External Pre-chargeback Alert	Relevant only for clients enrolled to external Ethoca alerts service via Nuvei – Notifies you that you received an Ethoca alert for an external (non-Nuvei) transaction.	Client
External RDR Case	Relevant only for clients enrolled to external RDR service via Nuvei – Notifies you that an RDR case has been processed for an external (non-Nuvei) transaction.	Client
Dispute API Action Callback	Relevant only for clients using Nuvei’s merchant’s Dispute API – Notifies you that you received a dispute action result response.	Client
Dispute API Image Callback	Relevant only for clients using Nuvei’s merchant’s Dispute API – Notifies you that you received the scan image result response.	Client
Instant Settlement	This feature available for merchants by request. Notifies you when Nuvei processes a settlement instantly.	Client
Terminal Created or Updated	An event that occurs when a new payment terminal is added to the system or when the details of an existing terminal are modified.	Client
PayFac Sub-merchant Created or Updated	Notifies payment facilitators about PayFac Sub-Merchant creation or update.	Multi-client
PayFac SubMerchants - PayFac Sub-Merchant Creation	Relevant only for payment facilitators, this notification acknowledge a successful creation of a sub-merchant account.	Multi-client
Error on Creating Terminal	Notifies you when the system fails to create a new payment terminal due to validation errors, missing information, or technical issues.	Client
Error on Creating PayFac Sub-Merchant	Notifies payment facilitators about an error in creating terminal.	Multi-client
Error on Updating Terminal	Notifies you when the system fails to create a new payment terminal due to validation errors, missing information, or technical issues.	Client
Error on Updating PayFac Sub-Merchant	Notifies payment facilitators about an error in updating PayFac Sub-Merchant.	Multi-client
External Pre-chargeback Alert	Notifies you that you received an Ethoca alert for an external (non-Nuvei) transaction.	Client
External RDR Case	Notifies you that an RDR case has been processed for an external (non-Nuvei) transaction.	Client
Omni Channel - PayFac Sub-Merchant Created or Updated	Notifies you that a PayFac sub-merchant account has been successfully created or an existing sub-merchant account has been updated based on Nuvei Omni channel solution.	Multi-client
Omni Channel - Error on Creating PayFac Sub-Merchant	Notifies you that an attempt to create a new PayFac sub-merchant account within the Omni Channel environment has failed due to validation errors, missing information, or technical issues.	Multi-client

Admin users see a single Select Client dropdown in the UI, while Master Clients see multiple dropdowns. A Master Client can use the single “Select Multi-client” dropdown to select a multi-client and set up endpoints and/or duplicate event settings for all multi-clients under that multi-client. In addition, a Master Client can use the Edit client option toggle switch to activate the second dropdown, which allows selecting an individual client under the multi-client and setting up endpoints and/or duplicating event settings for clients under other multi-clients or for clients under the same multi-client.

To ensure the accurate receipt of the Transaction ID in the appropriate format, we recommend that Merchants perform a conversion of the Transaction ID value from BigInt to String on their system upon receiving the notification.

Setting Up Endpoints

Merchants can configure endpoints to activate event push notifications and add an endpoint for each activated notification.

To set up an endpoint:

From the Menu bar, select Settings > My Account.
Select the Events Configuration tab.
From the dropdown(s), select the relevant client (or multi-client).
A table appears displaying existing event groups and event names.
From the Actions column, press for the relevant event name.
Enter valid URL endpoints (up to 5) to receive the event notification and press Save Changes.
Check that the Status toggle switch is turned on.

Duplicating Event Settings

Once merchants set up URL endpoints, they can duplicate these endpoints for the notifications between the clients of multi-clients or between the multi-clients under the master client.

To duplicate event settings:

From the Menu bar, select Settings > My Account.
Select the Events Configuration tab.
From the dropdown(s), select the relevant client (or multi-client).
A table appears displaying existing event groups and event names.
Press Duplicate Event Settings.
The Duplicate Event Settings window opens.
From the Client Name or Multi-client Name dropdown(s), select the relevant client(s) or multi-client(s) to which you want to paste the event settings.
Press Paste Settings and close the confirmation pop-up.

All dates in webhooks are in the UTC time zone, and are not affected by the user’s time zone.

Apple Pay Domain Verification

This tab can only be viewed by a user with Admin rights.

The merchant cannot process Apple Pay transactions until confirmed by Nuvei Technical Support.
Apple Pay configuration applies to all sites created under a merchant account.

We have added this section for Apple Pay Domain Verifications, which is a new interface for onboarding Apple Pay for merchants. This was created to simplify and streamline the setup so payments can be processed faster.

A merchant does not need to open a developer account and create their own certificates with Apple Pay; Nuvei performs all the work for the merchant.

To add an Apple Pay domain:

From the Menu bar, select Settings > My Account.
Select the Apple Pay Domain Verification tab.
A table of previously verified domains is displayed.
Press Add Domain.
Follow the steps in the window that opens:
1. In Step 1, enter the URL domain to register.
2. In Step 2, download the verification file from the URL and save it to the location that appears in the box in Step 3.
  The upload location that appears in Step 3 is configured by the merchant.
Press Verify.
The service is invoked and a call to Apple to register the merchant’s domain is performed. The certificates are configured for the merchant to be used both in the Apple and Nuvei systems.
Wait for the verification to complete and press Close.