Skip to main content

Nuvei

Extra data required

Nuvei expects to receive the following mandatory information in the extra_data field when creating the order:

  • Name and surname
  • Email address
  • Address

These fields can be provided with the following structure in extra_data:

"extra_data": {
"profile": {
"first_name": "John",
"last_name": "Doe",
"email": "johndoe@paynopain.com"
},
"address": {
"city": "Castellon",
"country": "ESP",
"address1": "Avinguda del Mar 23",
"zip_code": "12000",
"state_code": "CT"
}
}

Payment methods in Sandbox

Test cards are as follows. In general, the expiration date and CVV do not matter as long as the date is after the current date, and the CVV has 3 digits.

ResultCard
OK4000023104662535 12/34 123
KO (-1 Do not honor)5333463046218753 12/34 123

Error Codes

Error codes in Cybersource follow the following structure:

Code Message

For example:

-1 Do not honor

API errors

CodeMessage
1000General Error
1001Invalid checksum
1004Missing or invalid CardData data
1007Invalid name on card
1010Invalid user token
1011Missing or invalid UserPaymentOption data
1013Invalid merchant ID
1014{0}Invalid country code
1019Validation Error
1021Invalid timestamp
1022Invalid merchant site ID
1023User payment option is not enabled
1024UPO limit per user exceeded
1028Invalid card issuer
1029Invalid expired date
1038Communication error
1040Invalid or missing amount
1041Invalid or missing amount currency
1055Single UPO validation failed
1056User management is off
1057Invalid order ID
1058Requested operation cannot be performed on this order
1059Ambiguous payment data
1060Missing or invalid payment data
1061Invalid card token
1062Invalid CVV
1063Total amount does not match items amount sum
1064Invalid session token. There can be only one order per session token.
1065Invalid token
1066Invalid request
1067Invalid or missing transaction type
1068Payment method is not enabled
1069Session expired
1070The currency is not supported by the merchant payment option settings
1071Invalid request amount. The amount of the payment3D request is unequal to the amount of the Auth3D order.
1072Missing or invalid PA response
1073Invalid Order Currency. The currency of the payment 3D request and the currency of the Auth3D order are different.
1074The user payment option is expired.
1075Invalid language code
1076Unsupported payment method
1077API rebilling is disabled
1078Missing user payment option config
1079Rebilling is only allowed with user payment option.
1080Invocation of this method is forbidden
1081IP Address is blocked
1082Invalid value of relatedTransactionId
1083ekycUserDetails: The date of birth is invalid
1084UserDetails: The date of birth is invalid
1085Invalid request parameter value. The value of isPartialApproval should be empty or equal to 0 or 1
1086Sending of cardData block is not allowed
1087Invalid request xss content
1088Invalid clientRequestId. It should be provided when api setting is set to check it for uniqueness.
1089There is another transaction with this clientRequestId.
1090UPO is not in valid status. Valid statuses are ENABLED, SUSPENDED and FROZEN.
1091The transaction was processed by another merchant or merchant site.
1092The transaction does not support the requested operation
1093Missing message text!
1094Invalid message locale!
1095Invalid results range
1096Unknown status
1097Invalid value of account info field {0} in request.
1098Missing account info field {0} in request.
1099Payment method already registered!
1101{0}Invalid state
1102No such product descriptor
1103The subscription plan id is invalid
1104Temporary card token is forbidden for this method.
1105UserDetails: firstname, lastname, email, address, zip code and country are mandatory
1107Invalid methodCode
1108Invalid casino
1109Invalid email
1110Invalid locale code
1111External Error. Error received from IMS. IMS error message: {0}.
1112Registration failed
1113{0}The state is not from the country
1114Invalid verification status
1115Invalid verification method
1116Payment account details not found by IMS.
1117Invalid dynamic3DMode. The allowed values are: (off, on).
1118Invalid isDynamic3D. The allowed values are: (0, 1).
1120ekycUserDetails: invalid identificationType
1121Merchant not verified
1122Merchant site disabled
1123Invalid items count with open amount
1124Merchant site is not configured to execute Managed3D transaction.
1125UPO Payment method is not supported by this method.
1126When using rebilling, isDynamic3D must be equal to 1 and dynamic3DMode must be OFF.
1127When using externalMPI, isDynamic3D must be equal to 1 and dynamic3DMode must be OFF.
1128Invalid type: {0}
1129KYC Document Upload disabled.
1130Country could not be extracted from the request.
1131The originUrl = [{0}] is not valid!
1132The transaction has been already automatically settled.
1140A payment was not performed during this session.
2006Currency conversion is not supported.
90643D Authentication failure
9065The currency is not supported by the payment method
9066Exchange rate not available
9067Wrong payment method
9068Wrong DCC currency
9069Wrong converted amount
9070Wrong original currency
9071Wrong original amount
9072Payment is still in progress
9073Invalid or missing country and currency
9074externalSchemeDetails: Invalid or unsupported credit card company.
90753D Secure authentication failed, payment not allowed.
90763D Secure authentication failed.
9077Card registration failed.
9078Account Verification is not enabled for this Merchant Site.
9079Account Verification is not configured for this Payment Option and Country.
9080UPO is not in valid status. Valid statuses are ENABLED, SUSPENDED or DISABLED.
9081Invalid currency conversion type.
9082Payment Option supports single Passenger Details record only.
9083Invalid or missing clientRequestId.
9084Provided clientRequestId is not associated with a payout transaction.
9085Payment Option is not a Card.
9086Open Amount feature is not enabled.
9087Cannot use Open Amount and MCP Currency Conversion simultaneously.
9088Order Amount must be between %d and %d.
9089Open Amount feature is not supported for this order.
9090Cannot use Open Amount and Amount Details/Order Items simultaneously.
9091Balance retrieval error.
9092User account operation failed.
9093Account not found.
9094Account already registered.
9095Add Bank Account failed.
9096Cannot fund user account at this time.
9097Unsupported document type.
9098Unsupported enrollmentAction type.
9099Unsupported enrollment type.
91013D Authentication is required for Apple Pay transactions.
9102Invalid totalSettleCount

Processor errors

CodeReasonMessage
-1Call issuerRefers to the issuer. It is possible that such transactions could be authorized with voice AuthCode.
-1Invalid merchantGeneral decline message. Typically, this does not indicate any general issue with the merchant or MID. This decline reason is usually the result of an issue regarding an internal standard.
-1Pick up cardThis is a general decline message from the issuer indicating that the consumer should retrieve the card. This message may be received when the card is reported as lost/stolen.
-1Do not honorThe most common and general issuer decline code. This code is generated by the issuer when no specific decline reason/code is returned.
-1External Error in ProcessingThis is a general error message. When receiving this error, the transaction may succeed when trying again later.
-1Pick up card, special condition (fraud account)This is a general decline message from the issuer indicating that the consumer should retrieve the card. This message may be received when the card is reported as lost/stolen.
-1Invalid transactionThe most common and general issuer decline code. This code is generated by the issuer when no specific decline reason/code is returned.
-1Invalid amountThis decline code is the result of an issue with the transaction amount. This code may be triggered as a result of the currency or financial reasons such as insufficient funds.
-1Invalid card numberThe transaction could not be processed with the provided credit card number. This may indicate that the card number does not exist.
-1No such issuerThis decline code indicates that there is a problem with the credit card number, for example, the credit card BIN doesn’t match the range of any issuer in the acquirer’s list.
-1Unable to locate record in fileThe transaction failed due to a technical issue. When receiving this error, the transaction may succeed when trying again later.
-1File temporarily not availableThe transaction failed due to a technical issue. When receiving this error, the transaction may succeed when trying again later.
-1Format errorFor MasterCard or Maestro Card, this decline code may be the result of an invalid CVV number or a CVV number that could not be verified. This decline code may also be generated as the result of a 3D-Secure related issue, for example, the issuer requires transactions to be 3D-Secure and the transaction was processed through a Non-3D-Secure account.
-1No credit accountThis usually indicates that there is an issue with the account connected to the credit card, for example, the account is expired, cancelled, or does not exist.
-1Lost card, pickupThis decline code is returned when the card is listed as lost on the issuer’s side.
-1Stolen card, pickupThis decline code is returned when the card is listed as stolen on the issuer’s side.
-1Insufficient FundsThe credit card holder lacks sufficient funds to complete the transaction.
-1No checking accountThis usually indicates that there is an issue with the account connected to the credit card, for example, the account is expired, cancelled, or does not exist.
-1No savings accountThis usually indicates that there is an issue with the account connected to the credit card, for example, the account is expired, cancelled, or does not exist.
-1Expired cardThe credit card is no longer valid or was cancelled. It is also possible that the expiration date does not match the card details.
-1Incorrect PINThis decline code is similar to other PIN-based declines, and may indicate that the card is being blocked due to a security issue, such as exceeding the limit of PIN entry attempts at a point of sale.
-1Transaction not permitted to cardholderThe issuer did not allow this transaction against this card based on internal reasons, such as the transaction originated from a specifically restricted industry or country.
-1Transaction not permitted on terminalThe issuer rejected the transaction based on its technical origin or requester. When this error reoccurs, it may indicate that the Issuer does not allow transactions from this specific merchant or industry type.
-1Suspected fraudThe transaction is suspected to be fraudulent.
-1Exceeds withdrawal limitThe transaction amount exceeds the permitted amount for this card or account.
-1Restricted cardThe card is marked as restricted on the issuer’s systems.
-1Error in decryption of PIN blockThe decline code is the result of a security violation and may indicate that the card has been restricted.
-1Exceeds withdrawal frequencyThe transaction amount or count exceeds the permitted frequency for this card or account.
-1Invalid transaction; contact card issuerA general decline message likely indicating that the transaction was rejected for financial reasons, as well as the issuer’s internal standards.
-1PIN not changedThe transaction was declined as a result of the PIN code.
-1PIN tries exceededThe card was blocked on the issuer’s system due to an excessive amount of PIN entry attempts at the point of sale. This decline code may be returned during an online transaction even though the PIN is not entered for online transactions. This message may be received when a card was blocked following a card-present transaction.
-1Invalid “To” account specifiedThis decline code is also known as ‘Unsolicited Reversal’, and might mean that the ‘to’ [debit] account does not exist, is not connected to the card, or card was restricted.
-1Invalid “From” account specifiedThe ‘from’ [credit] account does not exist.
-1Invalid account specifiedThis indicates that there is an issue with the account associated to the credit card number, for example, the number does not exist or is invalid.
-1System not availableThis indicates that there was a technical issue preventing the completion of this transaction.
-1Cryptographic error found in PINThis decline code is similar to other PIN-based declines, and may indicate that the card is being blocked due to a security issue, such as exceeding the limit of PIN entry attempts at a point of sale.
-1Cannot verify PINThe transaction was declined as a result of the PIN code.
-1PIN unacceptable. Retry.The transaction was declined as a result of an unacceptable PIN code.
-1Issuer or switch inoperativeThe acquirer was unable to complete the transaction on the issuer’s side, for example, as a result of a timeout.
-1Routing errorThis indicates that the transaction request could not reach the authorizing destination (scheme/issuer). This may indicate that the credit card type is not processed by the acquirer.
-1Transaction cannot be completedThe issuer could not complete the authorization of this transaction. If this occurs again, the cardholder should try contacting the issuer.
-1Duplicate transactionIndicates that a transaction was sent twice.
-1Timeout/RetryA timeout occurred between the acquirer and the issuer.
-1Invalid CVV2The transaction was rejected as a result of the CVV2 and usually indicates that CVV2 provided does not match the credit card number. This code is relevant for Visa only.
-1Revocation of Authorization OrderThis decline code may indicate that the cardholder requested to discontinue recurring transactions.
-1Revocation of All Authorizations OrderThis decline code may indicate that the cardholder requested to discontinue recurring transactions.
-1Soft Decline – Authentication is AdvisedThe issuer has declined the transaction for authentication reasons. Running the transaction again with 3DS 2.0 / 1.0 might help to get the transaction approved.
-13D-Secure authentication failed, payment not allowed.Payment is not allowed. Do not request this payment again, not even as a Non-3D-Secure payment.
-1Closed account. Issuer will not approve same amount in next 30 days.The cardholder cancelled the card. Should not retry the transaction with this card.
-1Suspected fraud, issuer will not approve in the next 30 days same amount.Issuer marked the transaction as a suspected fraud. Should not retry the transaction with this card.
-1Closed accountThe cardholder cancelled the card.