Overview
The Exceptions Report is based on the ‘Transactions Report‘, but it displays only exceptions:
- Transactions that resulted with an error.
- Transactions that resulted with a filter error.
- Transactions that have been manually modified.
- Transactions that have been manually inserted.
The report is available for the following roles: ‘Management’, ‘Operations_Actions’, and ‘Operations_ReadOnly’.
Generating an Exceptions Report
Refer to the ‘Reports‘ page that explains the basic format of the reports that can be generated using the Control Panel. The page also describes how to use the various settings that allow you to generate a report with only the most relevant data, how to export your report, as well as create, schedule, and manage queries.
To generate an Exceptions Report:
- From the Menu bar, select ‘Operations’ > ‘Exceptions’.
- Press ‘Manage Page Settings‘ to set which parameters and how the parameters are displayed in the report.
- Use the available filters (via checkboxes and dropdowns) to narrow the search parameters of the report.
- Press ‘Run Report‘.
The report is displayed according to the settings and filters.
Exceptions Report
The results are displayed in descending order according to date. For information regarding an icon displayed in the report, hover over the icon to display a tooltip.
Above the ‘Search Result’ section, the filters used in the search are displayed and can be used to further refine the search.
Linkage Column
The ‘Linkage’ column contains two icons:
- Press
to open the ‘Transaction Life Cycle‘ window, which shows a summary of all the transaction details arranged by informational tabs, as well as a history of the transaction as it relates to other transactions (if relevant).
- Press
to show a summary of all the transaction details arranged by the same informational tabs as in the ‘Transaction Life Cycle‘ window.
Above the report table is the ‘Actions’ button, which allows you to perform various actions for the specific transaction. See ‘Actions‘.
Report Parameters
This section provides tables that describe the parameters that can be selected to be displayed in the report arranged by tabs using ‘Manage Report Settings’.
Transaction
| Parameter | Description | Notes |
|---|---|---|
| Transaction ID | The Nuvei transaction ID. | |
| Transaction Type | The transaction type of the transaction. | |
| Currency | The (original) currency of the transaction. | This may be different from the final currency of the transaction when the transaction is converted to another currency. |
| Amount | The (original) amount of the transaction. | This may be different from the final amount of the transaction when the transaction is converted to another currency. |
| Acquiring Bank | The acquirer bank or APM involved in the movement. | |
| Multi-client | The multi-client account in which the transaction was processed. | Multi-client accounts are made up of client accounts, each with their own transactions. |
| Modification Reason | When displaying modified transactions, displays the reason the transaction was modified. | If the Is Modified filter is set to No, this filter is disabled. |
| Client Name | The name of the Merchant account that was set in the payments Gateway and is associated with the transaction. | |
| Site Name | Cashier site ID created by Nuvei. | |
| APM Reference | The reference number of the APM used for the transaction. | |
| Client Unique ID | The ID of the transaction in the merchant’s system. | This value must be unique. This field is always displayed. |
| Is Partial Approval | Defines whether partial approval was executed. Possible values: Yes No | |
| Bank Transaction ID | A transaction ID provided by the APM or bank. | |
| Auth Code | The transaction's authorization code provided by the issuer bank. | |
| Custom Data | Any custom data you want displayed in the transaction details in the report. | |
| Is Credited | Indicates if the transaction was credited or not. | |
| Credit Type | The type of credit for transactions in which the customer was credited. Possible values: Refund – The customer is credited up to the full amount of the original transaction. Payout – The customer can be credited up to or beyond the original transaction. Fast Payout – The customer can be credited up to or beyond the original transaction within 30 minutes. Not a credit – When the transaction is not a refund or a payout. | |
| Is Modified | Indicates if the transaction was modified. | If this filter is set to No, the Modification Reason filter is disabled. |
| URL | The name of the site as defined by you through the customSiteName parameter. | If not defined, it is the name as configured in the Nuvei system. |
| ARN | The Acquirer Reference Number associated with the transaction. | |
| Provider Decline Reason | Decline reason as returned by the Provider’s API. | |
| Descriptor | Transaction’s merchant identifier for card statement. | |
| Exception Reason | Reason for Exception | |
| Comments | This field is used for manually modified transactions and specifies the reason why a transaction was modified. | |
| Transaction Result | This field specifies the latest corrected transaction result. It is presented in the following format: <Original Result> → <Corrected Result> Example: Declined → Approved This indicates the transaction result before and after the manual correction. | |
| Transaction Date | The date and time when the transaction was submitted. | The selected time range from the previous three years’ transactions that are to be searched. General reports (without using any search parameters) can be generated in intervals of up to six months. The date range for searches of specific parameters may be up to 12 months. This field is always displayed. |
| Modification Date | The last correction date. | |
| Modification Type | Displays the type of the modification made for this transaction. | |
| Category | The category the merchant selects before running a report. | Categories in the user-interface: Manually Modified – Transactions with results that are manually modified by Nuvei's Operation Team following mismatches/reconciliation. Manually Inserted – Transactions that are not sent by the merchant but are manually inserted by Nuvei's Operation Team. Errors – Unmanaged technical errors. Filter Errors – Technical filter errors filtered by the Nuvei system. |
Payment
| Parameter | Description | Notes |
|---|---|---|
| Name on Card | The customer's name as it appears on the credit/debit card. | |
| Payment Method | The icon of the payment method used for the transaction. | |
| PAN | First digit and last four digits of the credit card. | For example: 4***********7917 In Filters, the merchant can use the buttons just above the PAN text box to toggle between Credit/Debit Card and Alternative Method. |
| Issuer Bank | The name of the issuer bank for credit card transactions. | |
| Issuing Country | The location of the credit or debit card provider. | This icon represents the country's flag. You can place your mouse over the flag to see the country's name in a tooltip. |
| BIN | The first six digits of the credit/debit card that identifies the issuing institute. | |
| Card Type | Indicates what kind of card was used. Possible values: Debit Debit anonymous prepaid Debit prepaid Credit | |
| Expiration Date | The expiration date of the payment card. |
Consumer
| Parameter | Description | Notes |
|---|---|---|
| Email Address | The customer's email address. | You can view transactions that have been processed for the customer for the previous year by entering the customer's email address and changing the Date Range of the report. |
| IP Address | The customer's IP address. | |
| IP Country | The country where the IP address is located. | |
| User Token ID | Uniquely identifies the user in the merchant’s system. | The merchant passes this parameter to Nuvei. |
| User ID | The customer's ID that you assigned to the customer. | You can view specific users that have processed transactions according to their User ID in the previous year by entering the User ID and changing the Date Range. |
Last modified July 2026