Handling Direct Merchant Notifications
After the merchant sends a transaction to Nuvei, Nuvei communicates with the customer’s bank to transfer the deposit from the customer’s account to the merchant’s account. When Nuvei receives a response from the bank, Nuvei notifies the merchant of the result of the deposit via DMN.
DMNs are useful for determining when an error occurred on the customer’s side by verifying that the Nuvei server completed the transaction. There might be cases when the response coming through the Success or Error page is lost. When this occurs, the customer is not aware of the transaction outcome. As the merchant receives the DMN directly from Nuvei, the merchant can contact the customer to notify them of the status of the transaction.
Information Included in the Deposit DMN
- Transaction Parameters: The parameters of the transaction originally sent to the Cashier and the parameters of the outcome of the PPP’s work (including the response checksum).
- Payment Parameters: The unprotected payment method information, as updated by the customer in the Deposit page (name on card, expiration data, the last four digits of the credit card number, token, etc.).
- Customer Details: The customer’s personal information, as updated by the customer in the Deposit page (first and last name, the address, the contact details, etc.). By default, these parameters are returned, however, during your configuration you can instruct Nuvei to remove them from the response.
- Other Parameters: Merchant custom fields and other miscellaneous parameters.
Integrating DMNs
When the merchant integrates with Nuvei’s DMN, the Nuvei server executes an HTTPS request directly to the merchant web server without passing through the customer’s browser.
To integrate with the DMN, the merchant must provide to Nuvei the IP address of the URL that leads to the callback entry point to your server. This is usually a small module/application, which constantly listens and waits for incoming HTTPS requests from Nuvei’s server.
When the Nuvei server sends data via the DMN, Nuvei executes an HTTPS GET/POST request to the merchant’s server that includes the relevant parameters in the HTTPS GET/POST request.
Example:
The merchant provides the following DMN URL:
https://myserver.com/SafeCharge/dmn/receiveNotification
The Nuvei server calls back by using the HTTPS GET/POST request to the provided DMN URL. The request includes all the relevant data for the HTTPS GET/POST parameters.
For example, the Nuvei server executes the following HTTPS GET/POST request to the merchant’s server to send the response via DMN:
https://myserver.com/SafeCharge/dmn/receiveNotification?ppp_status=OK&PPP_TransactionID=547&TransactionID=45402&userid=111&merchant_unique_id=234234unique_id&customData=342dssdee&productId=12345product_id&first_name=Diyan&last_name=Yordanov&email=dido%40domain.com&totalAmount=47.25¤cy=USD&Status=APPROVED
Notes:
- If using HTTP GET – the body of the request remains empty.
- If using HTTP POST – the parameters are sent in the body of the request.
- If you need to switch the merchant configuration between HTTPS GET and HTTPS POST, then you need to contact Nuvei’s Integration Team.
Nuvei can send many DMNs at one time, depending on how many transactions and/or retries of failed attempts are being relayed simultaneously. Some firewalls, such as Incapsula, may recognize these as DDoS attacks and block Nuvei. It is recommended that merchant ensure that the following IP ranges are whitelisted with local and web firewalls.
Nuvei sends DMNs from the following IP addresses:
Test: IP DMN server range is: 91.220.189.12–91.220.189.16 / 52.16.211.57, 52.17.110.204
Live: Nuvei has several IP addresses for live DMN servers. A listener should be prepared to receive messages from the following IP addresses: 194.247.167.32 / 87.120.10.184 – 87.120.10.187
When using the DMN, Nuvei recommends that merchants use the merchant_unique_id
parameter.
The merchant_unique_id
parameter enables mapping between responses coming from DMN data.
To integrate DMNs, provide Nuvei with the IP and URL of the DMN listener in use.
Receiving DMN Notifications
When the DMN notification is sent to the merchant’s DMN URL, the Nuvei server expects the merchant’s server to respond with Status code 200 – OK. After the DMN is successfully sent, all the transactions that were successfully sent in that notification are recorded in the Nuvei database as Processed/Sent.
If the DMN is not successfully sent, the Nuvei database records the status of the transaction notification as In Retry, and the DMN attempts to resend the notification every 15 minutes for 24 hours. If the DMN fails to send the notification in each retry attempt over a 24-hour period, the DMN stops attempting to resend the notification and records the status of the notification as Failed.
If the IP address of your DMN listener has to be changed, the merchant must notify Nuvei in advance to prevent an interruption of the service.
Alternative Payment Methods (APMs) and DMN Notifications
After processing transactions through an APM, Nuvei returns a DMN that includes the result of the transaction in status
and in payment_method
, which identifies the payment method that the customer selected.
There are three possible values of status
:
- Approved: The transaction was processed and approved by the APM processer.
- Declined: The transaction was processed by the APM processer and declined.
- Pending: The transaction is being processed by the APM processer.
Transactions are processed synchronously and asynchronously depending on the APM. When an APM processes the transaction asynchronously, the length of time that passes before the transaction is processed can be several seconds to several days. After the final result (Approve or Decline) is received from the APM processor, Nuvei sends the merchant an additional DMN call with the same transaction data as the previous DMN call, with the exception of status
, which contains the final status of the transaction.
Authenticating a DMN Response Checksum
To authenticate a DMN callback, Nuvei includes a checksum among the HTTPS parameters in the DMN. This checksum should be used to verify that the DMN callback was sent by Nuvei. The checksum uses SHA-256 encryption same as the checksum generated when sending HTTPS requests to Nuvei’s server.
The HTTPS parameter containing the DMN checksum is named advanceResponseChecksum
.
To authenticate a DMN response checksum:
- Concatenate the following parameters in the exact order as follows:
The merchant secret key followed by the parameters received from the DMN callback:totalAmount
,currency
,responseTimeStamp
(in GMT),PPP_TransactionID
,Status
,productId
.
(If this parameter was not sent to Nuvei, then concatenate all item names instead. For example, Testproduct1 and Testproduct.) - Use SHA-256 encryption on the result string of the concatenation. Use encoding passed from the merchant site to create the encryption. The default encoding is UTF-8 (unless the encoding input parameter specifies otherwise).
Once the DMN response is received from Nuvei, compare the SHA-256 result to the advanceResponseChecksum parameter in the DMN callback.
Example of DMN Response Checksum:
Merchant Secret Key: AJHFH9349JASFJHADJ9834
totalAmount: 115
currency: USD
responseTimeStamp: 2020-03-14.16:22:34
PPP_TransactionID: 3453459
Status: APPROVED
productId: Your Product
After concatenation you have the following string:
AJHFH9349JASFJHADJ9834115USD2016-11-13.13:22:343453459APPROVEDYour Product
The calculated checksum is after using SHA-256 encryption:
6501f10efbfc9599d3e79fc0e24a5662e60292b0025834d0e2d09c58945aedbb
Information Included in the Pre-deposit DMN
-
Transaction Parameters: The parameters of the transaction originally sent to the Cashier and the parameters of the outcome of the PPP’s work (including the response checksum).
Missing parameters: Since no actual fiscal transaction has been performed the following parameters are not present in the DMN:ppp_status
, along with all fiscal related parameters and threeD parameters - Payment Parameters: The unprotected payment method information, as updated by the customer in the Deposit page (name on card, expiration data, the last four digits of the credit card number, token, etc.).
- Customer Details: The customer’s personal information, as updated by the customer in the Deposit page (first and last name, the address, the contact details, etc.). By default, these parameters are returned, however, during your configuration you can instruct Nuvei to remove them from the response.
- Other Parameters: Merchant custom fields and other miscellaneous parameters.
Handling Pre-deposit DMNs
After the customer attempts a deposit, Nuvei sends notification to the merchant’s pre-deposit DMN URL. Nuvei expects to receive from the merchant a DMN message response. Possible response values are as follows:
- Action: Approve – The deposit will be processed
- Action: Decline – The deposit is declined.
If the pre-deposit DMN is not successfully sent, the transaction attempt is declined. The pre-deposit DMN does not attempt to resend the notification.
DMN Parameters
All parameters are case sensitive.
Parameters | Mandatory | Description |
---|---|---|
ppp_status | Yes | The status of the transaction. OK indicates that the transaction was approved. Pending occurs only for APM transactions in which the final status is not immediately returned. FAIL indicates that the transaction was declined or there was an error. |
ppp_TransactionID | Yes | A unique 64-bit number that identifies the Nuvei payment page transaction. |
totalAmount | Yes | Total amount of all the items of a customer's purchase sent to the payment page. For merchants with the currency conversion feature enabled, the value of this parameter is original total amount of items before the currency is converted. |
currency | Yes | Currency selected by the customer that was sent to the payment page. For merchants with the currency conversion feature enabled, the value of this parameter is the original currency sent to the payment page. |
convertedCurrency | No | The final currency selected by the customer in the payment page in which the transaction was processed with the acquirer bank. This feature is available only for merchants with currency conversion enabled. |
convertedAmount | No | The final amount of the transaction after the customer converted the currency through the payment page. This is the amount that was processed through the acquirer bank. This feature is available only for merchants with currency conversion enabled. |
responsechecksum | Yes | Deprecated checksum parameter. |
advanceresponsechecksum | Yes | Advanced response checksum that ensures that the DMN callback is authenticate. |
transactionID | No | A unique 64-bit number that identifies the fiscal transaction in the Nuvei payment gateway. If no fiscal transaction actually occurred the ppp_status is FAIL and this parameter is empty. |
transactionType | No | The value of this parameter shows the type of transaction, Sale, Auth, Credit, Void, Chargeback, or Modification. This service is available only upon request. |
status | No | Status of the Nuvei Payment Gateway fiscal transaction: APPROVED, SUCCESS, DECLINED, ERROR, PENDING. If no fiscal transaction actually occurred, ppp_status is FAIL and this parameter value is DECLINED. |
userPaymentOptionId | No | Each time a customer uses a payment method, Nuvei assigns a unique ID to that payment method. The next time the customer uses a payment method in which Nuvei has already assigned an ID, the ID is returned as the value of this parameter. When a new payment method is used, the value of this parameter is empty. |
externalTransactionId | No | A unique ID generated by Nuvei that represents the APM transaction. |
userid | No | The string that you have passed as the userid parameter initially when making the HTTPS POST request to the payment page. |
customData | No | The ID which you have passed as the customData parameter initially when making the first request to the payment page. |
productId | No | The ID that you have passed as the productId parameter initially when making the first request to the payment page. |
first_name | No | Firstname of the user that processes a transaction, if supplied. |
last_name | No | Lastname of the user that processes a transaction, if supplied. |
No | Email of the user that processes a transaction, if supplied. | |
externalEmail | No | PayPal only. Email address returned from external alternative payment method. This parameter is the email address of the PayPal account. |
cardCompany | No | The name of the credit card company. The possible values are: Visa, Amex, MasterCard, Diners, Diners, Discover, JCB, LaserCard, Maestro, Solo, and Switch. This value is provided when the value of the payment_method parameter is cc_card or dc_card. |
customFieldX | No | Fifteen custom fields that you may use by replacing X with 1 to 15. The customFieldX that you have passed as the customFieldX parameter initially when making the first request to the Public Payment Page. |
invoice_id | No | The invoice_id that you have passed as the invoice_id parameter initially when making the first request to the Public Payment Page. |
address1 | No | Address1 of the user that processes a transaction, if supplied. |
address2 | No | Address2 of the user that processes a transaction, if supplied. |
country | No | Country of the user that processes a transaction, if supplied. |
state | No | State of the user that processes a transaction, if supplied. |
city | No | City of the user that processes a transaction, if supplied. |
zip | No | Zip code of the user that processes a transaction, if supplied. |
phone1 | No | Phone1 of the user that processes a transaction, if supplied. |
phone2 | No | Phone2 of the user that processes a transaction, if supplied. |
phone3 | No | Phone3 of the user that processes a transaction, if supplied. |
nameOnCard | No | Name on card of the user that processes a transaction, if supplied. |
cardNumber | No | Masked card number of the user that processes a transaction, if supplied. The parameter becomes mandatory if payment method is credit card or debit Card. If other payment method is used empty string is returned. |
expMonth | No | Expiration month of card used for this transaction, if supplied. The parameter becomes mandatory if payment method is credit card. If another payment method is used an empty string is returned. |
expYear | No | Expiration year of card used for this transaction, if supplied. The field becomes mandatory if payment method is credit card. If another payment method is used an empty string is returned. |
token | No | Tokens are strings of random digits, letters, and symbols characters that represent a single credit card number. When you submit your customers' full credit card number, Nuvei provides you with a token in the response that represents your customers' credit card. The next time a returning customer completes a transaction, you send Nuvei the token instead of the customer's credit card information. Nuvei returns this value in the response as well as the DMN response. |
tokenId | No | Deprecated. ID of the token. Used in combination with the token. |
orderTransactionId | No | This value is generated by PlayTech for transactions processed through PlayTech's Cashier. This value helps to identify individual transactions that are related to the same Order ID. |
3dflow | No | This parameter indicates if the transaction was processed through the 3DSecure flow or not: 0: Not processed through 3DSecure. 1: Processed through 3DSecure. Note: This parameter is currently only returned for 3DS 1.0. |
promoCode | No | This value is a promotional code you define that you can use to apply discounts to your products or services. Nuvei does not apply any discounts and only returns the value you sent in the HTTPS request. |
exErrCode | No | When a transaction is successful, this field is 0. When a transaction is not successful, the parameter is the code of the specific error. |
errCode | No | When a transaction is successful, this field is 0. When a transaction is not successful, the parameter is the code of the generic error. |
errApmCode | No | The error code for a transaction processed through an APM returned by the APM. |
errApmDescription | No | The error description for a transaction processed through an APM returned by the APM. |
errScCode | No | The error code for a transaction processed through an APM returned by Nuvei. |
errScDescription | No | The error description for a transaction processed through an APM returned by Nuvei. |
authCode | No | An authorization code (up to 35 characters) that is returned for each approved and pending transaction. |
acquirerId | No | Acquiring bank unique ID. The value 0 represents an invalid bank code. |
bin | No | The first six digits from the credit card number for identifying the processing bank. The rest of the number is not displayed. |
shippingCountry | No | Shipping country of the user that processes a transaction, if supplied. An empty string is returned when the shipping feature is not enabled. |
shippingState | No | Shipping state of the user that processes a transaction, if supplied. An empty string is returned when the shipping feature is not enabled. |
shippingCity | No | Shipping city of the user that processes a transaction, if supplied. An empty string is returned when the shipping feature is not enabled. |
shippingAddress | No | Shipping address of the user that processes a transaction, if supplied. An empty string is returned when the shipping feature is not enabled. |
shippingZip | No | Shipping Zip code of the user that processes a transaction, if supplied. An empty string is returned when the shipping feature is not enabled. |
shippingFirstName | No | Shipping first name of the user that processes a transaction, if supplied. An empty string is returned when the shipping feature is not enabled. |
shippingLastName | No | Shipping last name of the user that processes a transaction, if supplied. An empty string is returned when the shipping feature is not enabled. |
shippingPhone | No | Shipping phone of the user that processes a transaction, if supplied. An empty string is returned when the shipping feature is not enabled. |
shippingCell | No | Shipping mobile phone of the user that processes a transaction, if supplied. An empty string is returned when the shipping feature is not enabled. |
shippingMail | No | Shipping email of the user that processes a transaction, if supplied. An empty string is returned when the shipping feature is not enabled. |
total_discount | No | The total amount of all the values of the item_discount_X parameter combined. |
total_handling | No | The handling parameter that the merchant passed to Nuvei in the HTTPS POST request. |
total_shipping | No | The shipping parameter that the merchant passed as the shipping parameter initially when making the first request to the payment page. |
total_tax | No | The total tax parameter that you have passed initially when making the first request to the payment page. |
buyButtonProductBundleId | No | Contains the ID of the product bundle when the buy button payment was processed. |
merchant_site_id | Yes | The ID, provided by Nuvei, which uniquely defines a particular merchant customization. |
requestVersion | Yes | The version of the request. The current version is 3.0.0. |
message | Yes | A message from Nuvei about the transaction that has been done. |
merchantLocale | No | The language of the payment page. The possible values of this parameter is provided below: English (US): en_US English (UK): en_UK German: de_DE Chinese(PRC): zh_CN Hebrew: iw_IL French: fr_FR Dutch(Standard): nl_NL Greek: el_GR Indonesia: in_ID Italian: it_IT Japanese: ja_JP Korean: ko_KR Lithuanian: lt_LT Spanish: es_ES English (Canada): en_CA English (Australia): en_AU Russian: ru_RU Arabic: ar_AA Norwegian: no_No Portuguese: pt_BR Swedish: sv_SE Turkish: tr_TR Slovenian: sl_SI Danish: da_DK Romanian: ro_RO Bulgarian: bg_BG Polish: pl_PL Hungarian: hu_HU Vietnamese: vi_VL |
unknownParameters | No | When an unknown parameter is sent to Nuvei, for example, a misspelled parameter, Nuvei returns this parameter with the value being the parameter that Nuvei did not recognize. This enables you to identify and correct any erroneous parameters. |
payment_method | Yes | The payment method used for this transaction such as cc_card, dc_card, giro etc. |
ID | No | Hebrew ID |
merchant_id | Yes | The unique merchant ID supplied by Nuvei. |
responseTimeStamp | Yes | Time set by Nuvei, when the response is received from the Gateway. |
buyButtonProductId | No | Contains the ID of the product when the buy button payment was processed. |
dynamicDescriptor | Yes | Dynamic descriptor passed to the Nuvei gateway for the current transaction. |
reason | No | A reason that the Gateway returned if the transaction fails. See Gateway specification. N/A is returned if it is not a regular transaction. |
reasonCode | No | A reason code that the Gateway returned if the transaction fails. See Gateway specification. N/A is returned if it is not a regular transaction. |
item_name_X | Yes | The item name that you have passed as the item_name_X parameter initially when making the first request to the Public Payment Page. N/A is displayed if it is not a regular transaction. |
item_number_X | No | The item number that you have passed as the item_number_X parameter initially when making the first request to the Public Payment Page. N/A is displayed if it is not a regular transaction. |
item_amount_X | Yes | The item amount that you have passed as the item_amount_X parameter initially when making the first request to the Public Payment Page. N/A is displayed if it is not a regular transaction. |
item_quantity_X | No | The item quantity that you have passed as the item_quantity_X parameter initially when making the first request to the Public Payment Page. N/A is displayed if it is not a regular transaction. |
item_discount_X | No | The item discount that you have passed as the item_discount_X parameter initially when making the first request to the Public Payment Page. N/A is displayed if it is not a regular transaction. |
item_handling_X | No | The item handling that you have passed as the item_handling_X parameter initially when making the first request to the Public Payment Page. N/A is displayed if it is not a regular transaction. |
item_shipping_X | No | The item shipping that you have passed as the item_shipping_X parameter initially when making the first request to the Public Payment Page. N/A is displayed if it is not a regular transaction. |
appliedPromotions | No | Used to indicate that the purchase was done using a promotion (or coupon). This parameter will contact all successfully applied promotion codes. If more than one promotion was used, the promotion names will be separated by a # character. |
client_ip | Yes | The IP address from which the client made the purchase. |
uniqueCC | No | A unique value assigned to every credit card number. |
user_token | No | This parameter shows if the payment page required existing customers to register for the specific transaction. When user_token=register, the payment page required the customer to register even if they are already registered in the system. The previously registered payment methods are deleted. When user_token=auto, the payment page checked the Nuvei database to determine if the customer was already registered. |
user_token_id | No | This parameter is a unique identifier for each customer generated by the merchant. |
externalAccountID | No | This parameter is the customer's username or unique identifier provided by the APM. This value is not returned for all APMs. |
APMReferenceID | No | This parameter is Nuvei's reference identifier from Nuvei for each APM. |
webMasterId | No | The webMasterID you passed in the request to the Public Payment Page. |
finalFraudDecision | No | This parameter indicates the final fraud analysis decision made by Nuvei Risk management. Possible values: 1. Accept: The transaction is redirected for processing. 2. Reject: The transaction is rejected according to a Fraud Filter. |
systemID | No | The value of this parameter is a numeric identifier generated by Nuvei for the fraud analysis service/tool. |
systemName | No | The value of this parameter is an internal Nuvei name for the fraud analysis service/tool. |
systemDecision | No | The Risk decision. It may be one of the following predefined string values: 1. None: No decision was rendered. 2. Accept: Transaction is recommended for processing 3. Reject: Transaction is rejected due to a high probability of fraud. 4. Review: Transaction should be manually reviewed before processing. 5. Error: An error has occurred during the analysis. No decision is rendered. |
rules | No | This parameter lists all the rules that were activated by the transaction as part of Nuvei's fraud checks. This parameter is only returned when the value of the SystemDecision parameter is Reject or Review.The format of the value of the Rules parameter is URL encoded. For example: rules=ID%3D1000000260%2CDescription%3DCC+is+changing+more+than+1 +Email+Last+24+H+Review+general In the URL encoded response: %2C represents & and separates the multiple rule values. %3D represents '='. |
CVV2Reply | No | CVV2 (card verification value) response. Possible values: M – CVV2 Match N – CVV2 No Match P – Not Processed U – Issuer is not certified and/or has not provided Visa the encryption keys. S – CVV2 processor is unavailable. |
AVSCode | No | The AVS (address verification) response. The following values may be returned: A – The street address matches, the zip code does not. W – Whole 9-digit zip code match, the street address does not. Y – Both the 5-digit zip code and the street address match. X – An exact match of both the 9-digit zip code and the street address. Z – Only the 5-digit zip code matches, the street code does not. U – Issuer Unavailable S – Not Supported R – Retry B – Not Authorized (declined) N – Both street address and zip code do not match. |
cardType | No | The type of card used in the transaction. Possible values: credit or debit. |
upoRegistrationDate | No | The date that the UPO was registered in the following format: YYYMMDDHHmmss |
isPartialApproval | No | Indicates if the transaction was requested for partial approval (1) or not (0). |
requestedAmount | No | For a partial approval transaction, represents the amount requested. It can be greater than the amount that was able to be processed (totalAmount). |
partialApprovalStatus | No | For a partial approval transaction, indicates the status of the approval. Possible values: PENDING, APPROVED, CANCELLED, AUTO_VOID |
requestedCurrency | No | For a partial approval transaction, represent the currency of the amount requested. It should be the same as the currency of the amount processed (currency). |
isRebilling | No | Indicates whether this is a regular transaction or a recurring/rebilling transaction. Possible values: 0 – This is a regular transaction. 1 – This is a recurring/rebilling transaction. |
autoSettleMode | No | Automatic settle feature available for merchants working in an Auth-Settle mode. It can be configured to be done per “Accept” risk decision, per specific time frame or per combination of both. Possible values: TIME, RISK, RISK-TIME. |
isExternalMpi | No | Allow the merchant to provide the 3D Secure authentication result in the request to Nuvei. Possible values: 1 – external MPI is used 0 – external MPI is not used |
cavv | No | The card holder authentication verification value. Relevant for external MPI. |
xid | No | The transaction identification value. Relevant for external MPI. |
eci | No | The Electronic Commerce Indicator (ECI) indicates the level of security used in a 3D Secure program when the cardholder provides the payment information to the merchant. Possible ECI data values are: Visa: 5 – The cardholder was successfully authenticated 6 – The issuer or cardholder does not participate in a 3D Secure program 7 – Payment authentication was not performed Mastercard: 1 – The issuer or cardholder does not participate in a 3D Secure program 2 – The cardholder was successfully authenticated 6 – Payment authentication was not performed |
type | No | The type of the notification. Possible values: DEPOSIT WITHDRAWAL KYC DOCUP KYC and DOCUP are only relevant for merchants implementing Nuvei’s KYC solutions. |
3DauthenticationType | No | Presents whether transaction has been processed via challenge or frictionless authentication flow. Parameter should be calculated based on the combination of acsChallengeMandated/Result parameters in Auth3D response to Cashier by GW. Values: Challenge or Frictionless If the parameter is empty, the parameter is not included in the DMN. This field is relevant only for a 3DS 2.0 deposit flow. |
3Dauthentication | No | Result: ThreeDSAuthenticator -> result ->authenticationStatus. For frictionless, result value in Auth3d response to Cashier. For a challenge, send transStatus value from CRes. If the parameter is empty, the parameter is not included in the DMN. This field is relevant only for a 3DS 2.0 deposit flow. |
3Dreason | No | ThreeDReason: from final GW response to Cashier's Sale TRX. If the parameter is empty, the parameter is not included in the DMN. This field is relevant only for a 3DS 2.0 deposit flow. |
3DwhiteListStatus | No | whiteListStatus – from final GW response to Cashier's Sale TRX. If the parameter is empty, the parameter is not included in the DMN. This field is relevant only for a 3DS 2.0 deposit flow. |
clientRequestId | No | ID of the API request in merchant’s system. This value must be unique. Can be used to perform future actions, such as reconciliation, identifying the transaction in the event of any issues, etc. |
relatedTransactionId | No | The ID of the related transaction used if it was required for processing. |
merchant_unique_id | No | The ID value that was initially passed in the merchant_unique_id parameter when making the original request to the Nuvei Checkout Page. |
clientUniqueId | No | If transaction sent through Nuvei API, this parameter is populated by the ID of the transaction in the merchant’s system. |
externalTokenProvider | No | External token provider is a type of entity in the payment industry with its own flow (for example: Visa Checkout, Apple Pay). This indicates which external token provider was used in current transaction. |
isDecrypeService | No | External token provider is a type of entity in the payment industry with its own flow (for example: Visa Checkout). This indicates whether the payments gateway decrypted the external token data provided, which was required for processing. |
apmPayerInfo | No | Additional customer information that is received back from an external alternative payment service provider. |
3DReasonId | No | Reason ID for a failed 3DS authorization as received from the issuer. |
threeDReason | No | Reason description for a failed 3DS authorization as received from the issuer. |
challengeCancelReasonId | No | Reason ID for a cancelled 3DS authentication as received from the issuer. |
ChallengeCancelReason | No | Reason for a cancelled 3DS authentication as received from the issuer. |
isLiabilityOnIssuer | No | Indicates if there is a 3D Secure liability shift. |
challengePreferenceReason | No | If a challenge is requested, this field provides the reason for it. |
houseNumber | No | Indicates the provided house number. |
amountWithoutFee | No | The transaction amount without the fee. |
feeAmount | No | The amount of the transaction fee. |
manage_3d_mode | No | The value of manage3D mode that was submitted on the call:AUTO ON OFF |
acquirerBank | No | The name of the acquirer bank or payment processor of the processed transaction. |