Response Handling

Home    Online Payments    REST 2.0 (Beta Version)    Integration    Response Handling

On this page:

Overview

The tables below list error codes and messages that can appear in responses to Nuvei REST API requests, grouped according to HTTP status.

3DS Responses

In response to 3DS payment or authorization requests, the issuer returns a 3DS authentication result and, if applicable, the relevant 3DS challenge or exemption with its reason. See the REST 2.0 3DS Responses topic for details.

Response Code Tables

200 OK

Error CodeError Message
1300.1005Transaction confirmation by Merchant error
1400.1000<as returned by GW>
1600.1225Review
1900.1004Transaction declined by Merchant
5000.1004Invalid currency
5100.1136Mandatory fields are missing:
5100.1163Transaction must contain a Card/Token/Account.
5100.1210NameOnCard is missing
5200.1130The bank’s required fields are blank or incorrect.
5200.1133Gateway required fields are missing.
5200.1142AVS required fields are missing or incorrect
5200.1156Debit card required fields are missing or incorrect.
5200.1157No update parameters were supplied.
5200.11583D PARes value is incorrect.
5200.1230Invalid or missing PFSubMerchantId input parameter
5200.1231Invalid or missing MerchantName input parameter
5200.1232Invalid or missing PFSubMerchantCountry input parameter
5200.1233Invalid or missing PFSubMerchantCity input parameter
5200.1284Invalid external MPI parameters format
5200.1550Not all the auto reversal parameters were sent in the request
5200.1558Incorrect Auto-Reversal Input Parameters
5200.3501Mandatory POS Parameter is missing
5300.10012Saved payment option no longer valid
5300.10013Cannot register payment option at APM
5300.1003The request is still being processed
5300.1003Still Processing
5300.1107Cannot credit this credit card company.
5300.1109Unable to process this credit card company.
5300.1110Unrecognised credit card company.
5300.1118‘N’ cannot be a Positive CVV2 reply.
5300.1119‘B’/’N’ cannot be a Positive AVS reply.
5300.1120Invalid AVS.
5300.1121CVV2 check is not allowed in Credit/Settle/Void.
5300.1122AVS check is not allowed in Credit/Settle/Void.
5300.1131This transaction type is not allowed for this bank.
5300.1139This card is not supported in the CFT Program.
5300.1140Card must be processed in the GW System
5300.1144Must provide UserID in a Rebill transaction.
5300.1176Cannot void an auth transaction.
5300.1177Cannot void a credit transaction.
5300.1178Cannot void a void transaction.
5300.1179Cannot perform this void.
5300.1187Country does not support the CFT program.
5300.1196Sale transaction isn't yet processed on acquirer side.
5300.1198Credit card details are not allowed for the given payment method.
5300.1199Envoy payout transaction requires credit transaction of type 1.
5300.1204Payment method is not supported.
5300.1206Illegal interval between authorization and force
5300.1207Cannot perform this credit
5300.1208Converted transaction cannot be handled, please use alternative interfaces
5300.1209Cannot perform credit operation on MasterCard
5300.1211RESERVED
5300.1212RESERVED
5300.1213RESERVED
5300.1266Submethod not supported
5300.1267This card is not supported in the Visa Direct OCT program.
5300.1269Cannot get cryptogram
5300.1281Authentication has not completed
5300.1282Authentication failed
5300.1300Canceled
5300.2025External MPI not supported for this acquirer
5300.3010Only one of the fields %s must have a value
5300.3011At most one of the fields %s can have value
5300.3012%s must all have values or non has value
5350.1001Processing configuration not available
5350.1002Unknown transaction type
5350.1002Invalid Transaction Type Code
5350.1003Error in gateway configuration
5350.1004Token decryption configuration not available
5350.1005Notification configuration not available
5350.1006Error in notification configuration
5350.1007The Certificate integration is not valid
5350.1008The can be only one ACTIVE certificate for the same provider, type and integration per entity
5350.1009Invalid Certificate password
5350.1010Duplicate Certificate name
5350.1011The Certificate status is not valid
5350.1012The Certificate type is not valid
5350.1113Terminal is not ready for this credit card company.
5350.1141Transaction type is not allowed.
5350.1145Your Rebill profile does not supprt this transaction type.
5350.1209Client is not allowed for Partial Approval
5350.1270The client is not configured to account update
5350.1500Client Is Not Allowed To Use This Channel
5350.1501Client Is Not Allowed To Use Suppress Auth
5350.1551Client is not permitted to use auto reversal functionality
5350.1560Not Allowed to Process this Auth Type
5350.2002ApmRisk is disabled.
5350.3002Unsupported Payment Method
5350.3003Payment method is not enabled
5350.3004Payment method is not configured
5350.3006The payment option %s is not configured for currecny %s and country %s
5400.10003D Secure authentication failed
5400.11553D Related transaction is missing or incorrect.
5400.1182Transaction must be sent as 3D Secure.
5400.1183Account is not 3D enabled.
5400.1184Transaction 3D status is incorrect.
5400.1185Related transaction must be of type 'AUTH3D'.
5400.1186Related transaction must be 3D authenticated.
5400.1271sg_transaction must be of type InitAuth3D, Approved and the same merchant
5400.1272Card number must be equal for all transaction in a specific 3DS flow
5400.1273Card number, Currency and Amount must be equal in a specific 3DS flow
5400.1274Requested Auth3D 2.0 but card number is not supported with 3DS 2.0
5400.1275initAuth3D represented by sg_transactionId was already used in another 3D flow
5400.1276authentication request could not be completed – timeout, please try again later
5400.1277DS responded with an error, please verify request and try again
5400.1278Authentication is expired, new InitAuth3d is required
5400.12793D related transaction was already used for Sale/Auth
5400.1280Mandatory field is missing: sg_threeDSMethodNotificationURL
5400.1283Required field sg_ThreeDSPlatformType is missing or invalid
7400.1114Blacklisted card number.
7400.1116Custom Fraud Screen Filter.
8800.1162Age verification failed.

400 Bad Request

Error codeError Message
5000.1000Invalid input / actual error message is generated during the run time.
5000.1001Invalid expiration date.
5000.1002Ambiguous payment data provided
5000.1003Invalid name or code
5000.1005Invalid date input
5000.1012Payment Method %s does not support transaction type %s
5000.1102Invalid card number (length).
5000.1103Invalid card number (MOD 10).
5000.1104Invalid CVV2.
5000.1115Illegal BIN number.
5000.1125Format error.
5000.1128Invalid transaction type code.
5000.1138Invalid credit type.
5000.1143Country does not match ISO Code.
5000.1147Invalid account number.
5000.1148Invalid cheque number.
5000.1153Invalid bank code (number of digits)
5000.1154Invalid bank code (alpha numeric).
5000.1159State does not match ISO Code.
5000.1160Invalid bank code (checksum digit).
5000.1161This bank allows only 3 digits in CVV2.
5000.1164Invalid token.
5000.1165Token mismatch.
5000.1166Invalid email address.
5000.1169sg_ResponseFormat field is not valid.
5000.1170Version field is missing or incorrect
5000.1171Issuing country is invalid.
5000.1172Phone is missing or format error.
5000.1173Cheque number is missing or incorrect.
5000.1174Birth date format error.
5000.1175Zip code format error.
5000.1180Invalid start date.
5000.1181Merchant Name is too long (>25).
5000.1188Invalid token ID.
5000.1191RiskOnly is supported from version 4.0.0 and above.
5000.1193AGVOnly is supported from version 4.0.1 and above.
5000.1194Age verification mismatch.
5000.1195Requested acquirer is unrecognised.
5000.1197Input data is not sufficient.
5000.1201Invalid amount.
5000.1202Invalid currency.
5000.1203IBAN does not match country code.
5000.1214Invalid FinalizationURL
5000.1552Input parameter data type incorrect
5000.2001Missing mandatory input parameter buyerId
5000.2030Invalid external token provider
5000.3007The value of field %s is expected to be %s
5000.3500Invalid POS Parameter
5000.3502KYC parameters error
5100.3009Parameter %s is mandatory
5100.3017Input Validation failed. At least one field must have a value
5600.1000Currency conversion tolerance violation
5600.1001Invalid payment token
5600.1004{resource-name:(plan/subscription)} status is {status name}. Can't be changed to {requested status}
5600.1004Payment token not related to given buyer
5600.1006Payment not found
5600.1025A merchant reference already exists; it can’t be changed
5600.1029%s is not in the list of supported values
5600.1030Field %s is mandatory when %s = %s
5600.1031The Order does not support open amount functionality
5600.1032The amount must be between %d and %d
5600.1033openAmount.max cannot be less than openAmount.min
5600.1101Invalid card number (alpha numeric).
5600.1105Auth Code/Trans ID/Credit card number mismatch.
5600.1106Credit amount exceeds total charges.
5600.1111This transaction was charged back.
5600.1112Sale/Settle was already credited.
5600.1135Only one credit per sale is allowed.
5600.1150UserID/Trans Type /Trans ID mismatch.
5600.1152Transaction was already canceled.
5600.1167Transaction already settled.
5600.1168Transaction already voided.
5600.1206Settle amount exceeds total charges
5600.1207Duplicate check number
5600.1210Offline-approved
5600.1285Exceeding refund time frame
5600.1287Void is not supported for the related transaction type
5600.1288Void is not supported for the related transaction type in current processor
5600.1553Currency of auto reversal does not match the currency of the settle
5600.1554Amount of auto reversal does not match the amount of the settle and auth
5600.1555Auto Reversal Cannot be Allowed with Multiple Settle
5600.1556Settle amount plus AutoReversal Amount should bequal to Original Auth
5600.1557Original currency does not match auto reversal currency
5600.1559Cannot void auth, transaction has already been settled
5600.2000The External token provider is not valid
5600.3001Invalid Interval for sale reversal
5600.3002Invalid Interval for refund reversal
5600.3003Invalid Interval for OCT reversal
5600.3004Transaction has been already reversed
5600.3005Transaction is not approved
5600.3006Transaction type does not match reversal type
5600.3007Transaction has not been transmitted
5600.3008Transaction already has chargeback record
5600.3021Payment option already saved
5700.1002Expiration date has already passed.
5700.1108Invalid interval between authorisation and settle.
5700.1220Expired Token
5700.1265One year passed since last sale, Payout declined
5700.1268Token is inactive
5700.3019Token usage violates token sharing policy
5700.3020Merchant reference violates uniqueness policy
5800.1006Limit exceeding amount
5800.1124Total of credits amount exceeds restriction.
5800.1126Credit amount exceeds limit.
5800.1127The amount exceeds the limit.
5800.1132Amount exceeds bank limit.
5800.1137Credit count exceeded credit card company restriction.
5800.1146Void is not allowed due to customer credit card restriction.
5800.3005Amount %.2f is not within %s payment method allowed amount limits of %s %s
5800.3008The length os %s is not withing the configured limits of %s %s

401 Unauthorized

Error codeError Message
5300.3017Authorization Error
7300.1001Cannot validate Message Authentication Code
7300.10014APM authentication error
7300.3000Authorization Error
7300.3001Authorization Error
7300.3002Invalid JWT token

403 Forbidden

Error codeError Message
7500.1001Invalid login
7500.1005IP out of range
7500.3002Incorrect Authorizing or Processing entity
7500.3002Unknown entity or no permissions
7500.3002Feature is off
7500.3002Authorization error

404 Not Found

Error codeError Message
5900.1000Entity not found
5900.1001Parent Entity not found
5900.1002API Key not found
5900.1011Certificate not found
9100.1005Not found

500 Internal Server Error

Error CodeError Message
5500.1000Potential Loop detected
5500.1003input {resource-name:(plan/subscription)} not found
5500.1015Transaction cannot be voided
5500.1016Payment is not in status fingerprint
5500.1017Payment is not in status challenge
5500.1023Buyer is not in valid state
5500.1024Payment cannot be performed. Payment Token is not in active state
5500.1032Invalid Temporary Payment Token
5500.1149Account Number/Trans ID mismatch.
5500.1151Transaction does not exist in the rebill system.
5500.1189Invalid reference
5500.1289Issuer data is not available, please try again later
5500.3013Payment Token not found
5500.3016Buyer not found
7000.1000Internal system error
7000.1001Currency conversion rate not found
7000.1003Transaction processing error
7000.1003Error Locating Merchant Bank
7000.1004Error fetching transaction details
7000.1031Error creating Temporary Payment Token
7000.1129General filter error.
7000.1134AVS processor error.
7000.1190Risk processor error.
7000.1192AGV processor error.
7000.1205APM risk processor error.
7000.2001The requested acquirer bank is temporarily unavailable.
7000.2003Error in Decryption - Decryption can't be performed
7000.2006Error opening payment session: %s
7100.1000Communication error
7100.1001Balance is currently unavailable
7100.1203Timeout/Retry
7200.1001Cannot generate Message Authenticatioon Code
7200.1002Error during API Key creation
8000.10010QR Code expired
8000.1005Expired card
8000.1033Invalid effective date
8000.2022Transaction expired
8100.1268Address field is required
8300.10001Payment method not supported by APM connector
8300.10018Payment method not supported
8300.1020ACH: Mandate not found
8300.1027ACH: Duplicate Entry
8300.1031Mandate not Valid
8300.1032Mandate Cancelled
8300.1034New card issued
8300.1131Bank is not supported
8300.1132Process failed
8300.1133Process canceled
8300.1193Issuer or switch inoperative
8300.1196Duplicate transaction
8300.1207Duplicate check number
8300.1208MICR error
8300.1210Offline-approved
8300.1211Unable to go online; offline-approved
8300.1212Offline-declined
8300.1213Unable to go online; offline-declined
8300.1214Acquirer validation
8300.1217APM not available for merchant
8300.1218Payment not authorised by user
8300.1219Country not supported
8300.1220End user did not complete
8300.1222Transaction completed but not confirmed
8300.1229Delayed Processing
8300.1232Rejected by customer
8300.1234Currency conversion not supported
8300.1235Currency conversion error
8300.1236Not in Use
8300.1237API Test mode
8300.1242Credit Not Allowed
8300.1249Different funding option required
8300.1254Encryption error
8300.1258No action taken
8300.1263Force STIP
8300.2012Correction Not Supported
8300.2016Withdrawal Not Allowed
8300.2017Configuration Error
8301.10006Refund period exceeded the time limit
8301.10007Requested currency is different from the original currency
8301.10008Related Transaction Not Found
8301.10011Authorisation code checking error
8301.10017AMOUNT_MISMATCH
8301.1251Invoice not found
8301.1270Amount greater than related transaction
8301.1271The sum of the credited amount is larger than the original debit
8301.2004Transaction Exists
8301.2008Invoice Not Found
8301.2011Transaction Not Found
8400.1001Referral
8400.1002Call issuer
8400.1164No such issuer
8400.1174Transaction not permitted to cardholder
8400.1248Payment Denied
8400.9999Generic Decline
8401.1000Decline
8401.10013Declined
8401.1008ACH: Decline
8401.1150Insufficient funds
8401.1158Do not honor
8401.1241Consumer Cannot Pay
8401.2015Insufficient Funds
8402.10016Default
8500.10000Mandatory field is missing
8500.10002Incorrect request parameter
8500.10004Incorrect checksum
8500.10009Invalid validation code
8500.10022Card type verification error
8500.1015ACH: Country is not supported
8500.1016Invalid Account
8500.1017Invalid Account Number
8500.1018Invalid Bank Code
8500.1023Invalid CVV2
8500.1026ACH: Invalid Address
8500.1134Invalid payee
8500.1142Bank name field required
8500.1155Invalid card Number
8500.1156Invalid merchant
8500.1162Invalid transaction
8500.1163Invalid amount
8500.1167Format error
8500.1185Invalid account specified
8500.1189Negative CAM, dCVV, iCVV, or CVV results
8500.1215Missing argument
8500.1224Amounts discrepancy
8500.1225APM validation
8500.1228Currency not supported
8500.1231Invalid bank
8500.1238Invalid ID
8500.1239Invalid argument
8500.1240Wrong state for action
8500.1250Too Many Parameters
8500.1253Invalid phone number as user account ID
8500.1262Invalid biller information
8500.1272Consumer info validation failed
8500.2002Invalid Merchant Id
8500.2003Amount Mismatch
8500.2007Invalid Merchant Credentials
8500.2020Invalid User Credentials
8700.1004Timeout/Retry
8700.1128External Error In Processing
8700.1130Transaction Data Check Failed
8700.1187System not available
8700.1194Routing error
8700.1195Transaction cannot be completed
8700.1209Too many checks (over limit)
8700.1243DatabaseError
8700.1246Transaction cannot be completed; violation of law
8700.1247Login Failed
8700.1257System Error
8700.2010Unknown Error
8700.2018Technical Error
8700.2019Payment method Technical Error
8700.2021Merchant account problem
8800.10003Illegal IP address
8800.1003Lost/Stolen
8800.1006Blacklisted by the bank
8800.1025ACH: Rejected by the bank risk management
8800.1159Pick up card, special condition (fraud account)
8800.1169Lost card, pickup
8800.1170Stolen card, pickup
8800.1176Suspected fraud
8800.1206Unpaid items, failed negative file check
8800.1226Blacklisted by APM
8800.1227Blocked bank code
8800.1233Restricted card/bank account
8800.1255Sender IP address blocked
8800.1256The payer’s name is incorrect.
8800.1261Blocked, first used
8800.1273AVS Failed
8900.10020Encryption is not configured
8900.10021Data could not be decrypted
8900.1012ACH Processor Unknown Response
8900.1245APM maintenance
8901.10012Soft Decline - Authentication is Advised
8901.10024Invalid card status – status is other than active
8901.1009Account is blocked
8901.1030Account Closed
8901.1223Account locked
8901.1244Terms and conditions not accepted
8901.1259No current account
8901.1260Transaction does not fulfil AML requirement
8901.1269Refusal due to regulatory reasons
8901.2009Authentication Error
8901.2023User account problem
8902.1177Exceeds withdrawal limit
8902.1205Amount greater than established limit
8902.1216API call was rate limited.
8902.1221Receiving Limit exceeded
8902.1230Exceeds transaction limit
8902.1252Payment amount is less than the limit
8902.2005Deposit Minimum
8902.2006Deposit Maximum
8902.2013Withdraw Minimum
8902.2014Withdraw Maximum
8902.9998SL: Above max transaction limit
8903.10014Custom fraud screen filter
8903.10019PIN Code is required
8903.10023Terminal not authenticated
8903.1264Unsafe PIN
8903.1267CANNOT LOGIN
8904.10005APM timeout
9000.1002Can’t delete the gatewayAccount configuration. There is at least one processingEntity which uses the gatewayAccount configuration
9000.1002Can’t delete the gateway configuration. There is at least one authorizationEntity which uses the gateway configuration.
9000.1002Can’t update the gateway type. There is at least one authorizationEntity which uses the gateway configuration.
9000.1002Can’t delete the entity configuration. There is at least one transaction for it
9000.1002Can’t delete the gatewayAccount configuration. There is at least one processingEntity which uses the gatewayAccount configuration
9000.1002Can’t delete the gateway configuration. There is at least one authorizationEntity which uses the gateway configuration.
9000.1002Can’t update the gateway type. There is at least one authorizationEntity which uses the gateway configuration.
9000.1002Can’t delete the entity configuration. There is at least one transaction for it
9000.1027Can't update the payment token uniqueness policy. There are payment tokens related to the entityId given
9000.1028Can't update the entityBuyers setting for the entity. There are buyers related to the entityId given
Last update iconLast modified November 2024