Overview

This document provides information about endpoints and statuses, error codes, and messages that can appear in responses to Nuvei REST API requests.

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 Statuses by Endpoint (common statuses)

Endpoint	Common Statuses
POST /payouts	approved, declined, error
POST /payments/{payment-id}/refunds
POST /payments/{payment-id}/settles
POST /payments/{payment-id}/voids

Payment Endpoints (extended status values)

Endpoint	Statuses
POST /payments	approved, authorizedOnly, declined, error, pending, redirect, challenge, fingerprint
POST /payments/{payment-id}/fingerprint	approved, authorizedOnly, declined, error, challenge
POST /payments/{payment-id}/challenge	approved, authorizedOnly, declined, error

Endpoints Returning Only Statuses ‘success’ or ‘error’

Payment Tokens

Endpoint	Statuses
POST /payment-tokens	success, error
GET /payment-tokens/{payment-token-id}
PATCH /payment-tokens/{payment-token-id}
POST /temporary-payment-tokens

Buyers

Endpoint	Statuses
GET /buyers	success, error
PUT /buyers/{buyer-id}
GET /buyers/{buyer-id}
GET /buyers/{buyer-id}/payment-tokens
GET /buyers/{buyer-id}/payment-tokens/{payment-token-id}

Card Details

Endpoint	Statuses
POST /card-details	success, error

Payment Options

Endpoint	Statuses
GET /payment-options	success, error

Network Tokens

Endpoint	Statuses
POST /network-tokens	success, error
POST /network-tokens/cryptograms
GET /network-tokens/{payment-token-id}

DATA and Currency APIs

Endpoint	Statuses
GET /currencies/entities/{processing-entity-id}/rates	success, error
GET /entities/{processing-entity-id}/transactions/{transaction-id}
GET /entities/{processing-entity-id}/transactions

Balance API

Endpoint	Statuses
GET /pix/entities/{entity-id}/balances	success, error
GET /pix/entities/{entity-id}/closing-balances/{report-date}

Order API

Endpoint	Statuses
POST /orders, PATCH /orders	success, error
GET /orders/status	authorizedOnly, declined, error, pending, redirect, challenge, fingerprint

Response Code Tables

HTTP Status Code 200 – OK

The HTTP status code ‘200 – OK’ indicates that a request is successfully completed by the server.

Decline Statuses with HTTP Status Code 200

This section provides information about decline status codes with HTTP status code 200.
A decline status with HTTP status code 200 indicates that an API request is correct and successfully reached the financial institution but that the issuer (the customer’s financial institution) refuses to accept the transaction.

1000 Decline Statuses with HTTP Status Code 200

A 1000 message is provided because of a decline caused by bad decline reasons.

Decline Status Code	Decline Status Message
1000.1016	Invalid Account
1000.1017	Invalid Account Number
1000.1018	Invalid bank code
1000.1023	Invalid CVV2
1000.1024	Invalid AVS
1000.1033	Invalid effective date
1000.1129	Signature failed
1000.1154	Invalid issue number
1000.1155	Invalid card number
1000.1156	Invalid merchant
1000.1162	Invalid transaction
1000.1163	Invalid amount
1000.1167	Format error
1000.1180	Invalid transaction; contact card issuer.
1000.1183	Invalid 'To' account specified.
1000.1184	Invalid 'From' account specified.
1000.1185	Invalid account specified.
1000.1238	Invalid ID
1000.1239	Invalid argument
1000.1256	The payer’s name is incorrect.
1000.1262	Invalid biller information
1000.1268	Address field is required.
1000.2002	Invalid merchant Id
1000.2003	Amount mismatch
1000.2007	Invalid merchant credentials.
1000.2008	Invoice not found.
1000.10000	Mandatory field is missing.
1000.10002	Incorrect request parameter
1000.10011	Authorization code checking error
1000.10024	Invalid card status – status is other than active.
1000.10027	Invalid authorization code
1000.10032	Merchant id is missing.
1000.10043	Original transaction amount error
1000.10050	Items not on bankbook beyond limit, declined.
1000.10052	Invalid billing information
1000.10054	Card holder billing address data is required when performing AVS check.
1000.10068	Transaction amount must be greater then zero.
1000.10075	Only last transaction can be reversed.
1000.10084	Only initial authorize can be captured.
1000.10087	Parent transaction id is required for this operation.
1000.10099	The security code or expiration date was invalid.
1000.10106	Missing currency
1000.10107	Invalid currency
1000.10111	Invalid IP
1000.10118	Invalid credentials
1000.101257	Invalid or missing state code
1000.101258	Invalid token
1000.101281	Invalid expiry date
1000.101282	Invalid card holder
1000.101299	Invalid user details (e.g. name, email, phone)
1000.101407	Payee first name / last name is missing or invalid.
1000.101408	Payer details are missing or invalid.
1000.101432	Invalid request
1000.101439	Incorrect zip code
1000.101452	Mandatory descriptor value is missing.
1000.101455	Invalid address

1100 Decline Statuses with HTTP Status Code 200

A 1100 message is provided because of a decline caused by credential decline reasons.

Decline Status Code	Decline Status Message
1100.2009	Authentication error
1100.2020	Invalid user credentials

1200 Decline Statuses with HTTP Status Code 200

A 1200 message is provided because of a decline caused by insufficient funds decline reasons.

Decline Status Code	Decline Status Message
1200.1150	Insufficient funds

1300 Decline Statuses with HTTP Status Code 200

A 1300 message is provided because of a decline caused by technical reasons.

Decline Status Code	Decline Status Message
1300.1004	Timeout/Retry
1300.1005	Transaction confirmation by Merchant error
1300.1009	Account is blocked
1300.1021	Account/Bank mismatch
1300.1030	Account closed
1300.1125	Error in 3DSecure processing
1300.1131	Bank is not supported
1300.1132	Process failed
1300.1133	Process canceled
1300.1137	Account number mismatch
1300.1140	Check digits mismatch
1300.1157	Pick-up card
1300.1159	Pick up card, special condition (fraud account)
1300.1160	Partial approval
1300.1164	No such issuer
1300.1165	Unable to locate record in file
1300.1168	No credit account
1300.1171	No checking account
1300.1172	No savings account
1300.1173	Incorrect PIN
1300.1174	Transaction not permitted to cardholder
1300.1175	Transaction not permitted on terminal
1300.1178	Error in decryption of PIN block
1300.1181	PIN not changed
1300.1182	PIN tries exceeded
1300.1186	Already reversed
1300.1187	System not available
1300.1188	Cryptographic error found in PIN
1300.1189	Negative CAM, dCVV, iCVV, or CVV results
1300.1190	No reason to decline
1300.1191	Cannot verify PIN
1300.1192	PIN unacceptable. Retry.
1300.1193	Issuer or switch inoperative
1300.1194	Routing error
1300.1196	Duplicate transaction
1300.1197	Ineligible for resubmission
1300.1206	Unpaid items, failed negative file check
1300.1207	Duplicate check number
1300.1208	MICR error
1300.1211	Unable to go online; offline-approved
1300.1212	Offline-declined
1300.1213	Unable to go online; offline-declined
1300.1214	Acquirer validation
1300.1215	Missing argument
1300.1220	End user did not complete
1300.1235	Currency conversion error
1300.1243	Database error
1300.1255	Sender IP address blocked
1300.1257	System error
1300.1259	No current account
1300.1260	Transaction does not fulfil AML requirement
1300.1263	Force STIP
1300.1264	Unsafe PIN
1300.1274	Verification data failed
1300.2004	Transaction exists
1300.2010	Unknown error
1300.2011	Transaction not found
1300.2016	Withdrawal not allowed
1300.2017	Configuration error
1300.2018	Technical error
1300.2019	Payment method Technical Error
1300.2021	Merchant account problem
1300.2022	Transaction expired
1300.2023	User account problem
1300.10003	Illegal IP address
1300.10004	Incorrect checksum
1300.10007	Requested currency is different from the original currency
1300.10008	Related transaction not found
1300.10018	Payment method not supported
1300.10019	PIN code is required
1300.10020	Encryption is not configured
1300.10021	Data could not be decrypted
1300.10022	Card type verification error
1300.10023	Terminal not authenticated
1300.10036	Remove token or token expired
1300.10037	User cancellation
1300.10045	Visa transactions: credit issuer unavailable. Private label: invalid date
1300.10047	Cryptographic failure
1300.10064	Wrong remote payments program.
1300.10069	Sale point account not found
1300.10072	Reverse operation is allowed only for last transaction.
1300.10076	Transaction has been already reversed.
1300.10077	Recurring payment not found.
1300.10082	Reverse currency should match original authorize currency
1300.10086	Duplicated request is not allowed.
1300.10088	Second presentment has already been created for this transaction.
1300.10090	Terminal not found.
1300.10092	S3D error: Authentication failed. S3D error status code: 0
1300.10093	BIN range is not available at the moment. Try again, or contact support.
1300.10094	Original authorize is recurring, subsequent requests must also be sent as recurring.
1300.10096	Cutoff is in process
1300.10100	You must repeat the transaction.
1300.10102	The message returned by the financial network is inconsistent.
1300.10105	Operation not supported
1300.10121	Transaction not allowed
1300.10124	Overpaid
1300.10127	Re-enter transaction
1300.10129	Not authorized. Try later
1300.10130	ATC - Out of Sequence
1300.10131	Unable to stop recurring
1300.101279	Unable to refund
1300.101401	Void is not supported for the related transaction type.
1300.101402	Void is only supported for authorized transactions.
1300.101405	The client is not configured to external authorization
1300.101410	CID verification error
1300.101416	Unable to cancel transaction
1300.101446	Risk management error.
1300.101450	Duplicated transaction. Try later
1300.101451	Retry the transaction later
1300.101514	Transaction in an inconsistent state.
1300.101520	Bank scheme

1400 Decline Statuses with HTTP Status Code 200

A 1400 message is provided because of a decline caused by general reasons.

Decline Status Code	Decline Status Message
1400.1000
1400.1001	Referral
1400.1002	Call issuer
1400.1031	Mandate not valid
1400.1034	New card issued
1400.1124	Failed 3DSecure authentication
1400.1126	Attempted but card not enrolled
1400.1127	Card not eligible
1400.1128	External error in processing
1400.1152	Restricted card
1400.1158	Do not honor
1400.1195	Transaction cannot be completed
1400.1199	Stop payment order
1400.1202	Revocation of all authorizations order
1400.1204	Check is OK but cannot be converted
1400.1219	Country not supported
1400.1228	Currency not supported
1400.1232	Rejected by customer
1400.1233	Restricted card/bank account
1400.1234	Currency conversion not supported
1400.1242	Credit not allowed
1400.1246	Transaction cannot be completed; violation of law
1400.1248	Payment denied
1400.1258	No action taken
1400.1269	Refusal due to regulatory reasons
1400.1272	Consumer info validation failed
1400.1273	AVS Failed
1400.1275	Closed account
1400.1280	Closed account by issuer. Issuer will not approve same amount in next 30 days
1400.2030	Life cycle
1400.9999	Generic decline
1400.10012	Soft Decline - authentication is advised
1400.10013	Declined
1400.10028	Authorization code expired
1400.10033	Card not effective
1400.10035	Decline given by POS participant (adjustment)
1400.10039	Decline. Customer cancellation
1400.10040	Card not initialized
1400.10041	Decline. Partial reversal
1400.10042	Fallback transaction is not allowed
1400.10046	Domestic debit transaction not allowed (regional use only)
1400.10049	Strong customer authentication requried
1400.10053	PIN change/unblock request declined
1400.10056	Can not refund transaction which do not have captured or cleared state.
1400.10059	Can not refund because transaction is already refunded.
1400.10060	Authorize is already cancelled.
1400.10061	Authorize expired.
1400.10062	Can not reverse captured transaction.
1400.10065	Card processing is forbidden
1400.10066	Recurring payment is not allowed
1400.10067	Time gap between recurring payment requests is too low
1400.10073	Reverse period has expired.
1400.10074	Reverse authorize is not valid.
1400.10078	Refund currency is not the same as transactions currency
1400.10079	Cannot reverse sent for clearing transactions
1400.10080	Recurring payment was not initiated
1400.10081	This type of operation is not available for this type of card
1400.10083	Cancelled transaction cannot be reversed.
1400.10085	Source of funds value (VALUE) is not allowed for this merchant
1400.10089	Cancel is not allowed for this procedure.
1400.10097	Successful transaction with fault
1400.10101	The transaction is subject to be transmitted to the financial network. This usually applies to transactions with cash payment means.
1400.10128	Denied, do not repeat before 72 hours.
1400.101273	Customer personal information mismatch
1400.101404	Batch number of the transaction was marked as closed in the last 60 days
1400.101422	Rejected by bank
1400.101435	Card declined
1400.101441	Request not allowed
1400.101474	Currency mismatch
1400.101524	Purchase amount only, no cash back allowed
1400.101530	Policy
1400.101531	Call issuer, special conditions

1500 Decline Statuses with HTTP Status Code 200

A 1500 message is provided because of a decline caused by limits.

Decline Status Code	Decline Status Message
1500.1005	Expired card
1500.1177	Exceeds withdrawal limit
1500.1179	Exceeds withdrawal frequency
1500.1198	Transaction amount exceeds preauth amount
1500.1205	Amount greater than established limit
1500.1209	Too many checks (over limit)
1500.1221	Receiving limit exceeded
1500.1230	Exceeds transaction limits
1500.1252	Payment amount is less than the limit
1500.1270	Amount greater than related transaction
1500.1271	The sum of the credited amount is larger than the original debit
1500.10006	Refund period exceeded the time limit
1500.10030	Exceeded retry limit, issuer will never approve
1500.10031	Exceeded retry limit, issuer cannot approve at this time
1500.10051	Cashback request exceeds issuer limit
1500.10055	Capture amount must be greater than zero.
1500.10057	Refund amount must be greater than zero.
1500.10058	Amount to be refunded is greater than captured amount.
1500.10063	Reverse amount must be greater than zero.
1500.10070	Reverse amount must be equal to authorize amount.
1500.10071	Reverse amount must be less or equal to authorize amount.
1500.10104	Amount is greater than available balance
1500.10108	Exceeds monthly limits
1500.10109	Exceeds daily limits
1500.10113	Expired token
1500.101436	Partner has exceeded the cycle limit configured in the system
1500.101442	Refund amount exceeds transfer value.

1600 Decline Statuses with HTTP Status Code 200

A 1600 message is provided because of a decline caused by suspected fraud.

Decline Status Code	Decline Status Message
1600.1003	Lost/Stolen
1600.1006	Black listed by the bank
1600.1149	Retain card
1600.1169	Lost card, pick-up
1600.1170	Stolen card, pick-up
1600.1176	Suspected fraud
1600.1225	Review
1600.1261	Blocked, first used-transaction from new cardholder, and card not properly unblocked
1600.1281	Suspected fraud by issuer. Issuer will not approve same amount in the next 30 days.
1600.10034	Security violation
1600.101259	Blocked token

1700 Decline Statuses with HTTP Status Code 200

A 1700 message is provided because of a decline caused by provider timeout errors.

Decline Status Code	Decline Status Message
1700.1022	ACH: Timeout/Retry

1800 Decline Statuses with HTTP Status Code 200

An 1800 message is provided because of a decline caused by provider errors.

Decline Status Code	Decline Status Message
1800.1008	ACH: Decline
1800.1010	ACH: Account number expired
1800.1014	ACH: Cancellation period expired

Input Errors with HTTP Status Code 200

An input error with HTTP status code 200 indicates that the server successfully received a message but that the message data failed Nuvei internal validation rules.

This section provides information about input error codes with HTTP status code 200.

5100 Input Errors with HTTP Status Code 200

A 5100 message is provided because of an input error caused by a missing mandatory fields error.

Error Code	Error Message
5100.1136	Mandatory fields are missing.
5100.1163	Transaction must contain a Card/Token/Account.
5100.1210	NameOnCard is missing.

5200 Input Errors with HTTP Status Code 200

A 5200 message is provided because of an input error caused by a missing conditional input error.

Error Code	Error Message
5200.1130	The bank’s required fields are blank or incorrect.
5200.1133	Gateway required fields are missing.
5200.1142	AVS required fields are missing or incorrect
5200.1156	Debit card required fields are missing or incorrect.
5200.1157	No update parameters were supplied.
5200.1158	3D PARes value is incorrect.
5200.1230	Invalid or missing PFSubMerchantId input parameter
5200.1231	Invalid or missing MerchantName input parameter
5200.1232	Invalid or missing PFSubMerchantCountry input parameter
5200.1233	Invalid or missing PFSubMerchantCity input parameter
5200.1284	Invalid external MPI parameters format
5200.1550	Not all the auto reversal parameters were sent in the request
5200.1558	Incorrect Auto-Reversal Input Parameters
5200.3501	Mandatory POS Parameter is missing

5300 Input Errors with HTTP Status Code 200

A 5300 message is provided because of an input error caused by advanced errors.

Error Code	Error Message
5300.1001	No domains currently registered with Apple Pay
5300.10012	Saved payment option no longer valid
5300.10013	Cannot register payment option at APM
5300.1003	The request is still being processed
5300.1003	Still Processing
5300.1004	No financial transaction has been performed in this session
5300.1107	Cannot credit this credit card company.
5300.1109	Unable to process this credit card company.
5300.1110	Unrecognised credit card company.
5300.1118	‘N’ cannot be a Positive CVV2 reply.
5300.1119	‘B’/’N’ cannot be a Positive AVS reply.
5300.1120	Invalid AVS.
5300.1121	CVV2 check is not allowed in Credit/Settle/Void.
5300.1122	AVS check is not allowed in Credit/Settle/Void.
5300.1131	This transaction type is not allowed for this bank.
5300.1139	This card is not supported in the CFT Program.
5300.1140	Card must be processed in the GW System
5300.1144	Must provide UserID in a Rebill transaction.
5300.1176	Cannot void an auth transaction.
5300.1177	Cannot void a credit transaction.
5300.1178	Cannot void a void transaction.
5300.1179	Cannot perform this void.
5300.1187	Country does not support the CFT program.
5300.1196	Sale transaction isn't yet processed on acquirer side.
5300.1198	Credit card details are not allowed for the given payment method.
5300.1199	Envoy payout transaction requires credit transaction of type 1.
5300.1204	Payment method is not supported.
5300.1206	Illegal interval between authorization and force
5300.1207	Cannot perform this credit
5300.1208	Converted transaction cannot be handled, please use alternative interfaces
5300.1209	Cannot perform credit operation on MasterCard
5300.1266	Submethod not supported
5300.1267	This card is not supported in the Visa Direct OCT program.
5300.1269	Cannot get cryptogram
5300.1281	Authentication has not completed
5300.1282	Authentication failed
5300.1300	Canceled
5300.2025	External MPI not supported for this acquirer
5300.3010	Only one of the fields %s must have a value
5300.3011	At most one of the fields %s can have value
5300.3012	%s must all have values or non has value
5300.3017	Authorization Error

5350 Input Errors with HTTP Status Code 200

A 5350 message is provided because of an input error caused by configuration errors.

Error Code	Error Message
5350.1001	Processing configuration not available
5350.1002	Unknown transaction type
5350.1002	Invalid Transaction Type Code
5350.1003	Error in gateway configuration
5350.1004	Token decryption configuration not available
5350.1005	Notification configuration not available
5350.1006	Error in notification configuration
5350.1007	The Certificate integration is not valid
5350.1008	The can be only one ACTIVE certificate for the same provider, type and integration per entity
5350.1009	Invalid Certificate password
5350.1010	Duplicate Certificate name
5350.1011	The Certificate status is not valid
5350.1012	The Certificate type is not valid
5350.1013	Domain not registered
5350.1014	Domain is disabled
5350.1015	Domain already registered
5350.1113	Terminal is not ready for this credit card company.
5350.1141	Transaction type is not allowed.
5350.1145	Your Rebill profile does not supprt this transaction type.
5350.1209	Client is not allowed for Partial Approval
5350.1270	The client is not configured to account update
5350.1500	Client Is Not Allowed To Use This Channel
5350.1501	Client Is Not Allowed To Use Suppress Auth
5350.1551	Client is not permitted to use auto reversal functionality
5350.1560	Not Allowed to Process this Auth Type
5350.2002	ApmRisk is disabled.
5350.3002	Unsupported Payment Method
5350.3003	Payment method is not enabled
5350.3004	Payment method is not configured
5350.3006	The payment option %s is not configured for currecny %s and country %s

5400 Input Errors with HTTP Status Code 200

A 5400 message is provided because of an input error caused by SCA/3D errors.

Error Code	Error Message
5400.1000	3D Secure authentication failed
5400.1155	3D Related transaction is missing or incorrect.
5400.1182	Transaction must be sent as 3D Secure.
5400.1183	Account is not 3D enabled.
5400.1184	Transaction 3D status is incorrect.
5400.1185	Related transaction must be of type 'AUTH3D'.
5400.1186	Related transaction must be 3D authenticated.
5400.1271	sg_transaction must be of type InitAuth3D, Approved and the same merchant
5400.1272	Card number must be equal for all transaction in a specific 3DS flow
5400.1273	Card number, Currency and Amount must be equal in a specific 3DS flow
5400.1274	Requested Auth3D 2.0 but card number is not supported with 3DS 2.0
5400.1275	initAuth3D represented by sg_transactionId was already used in another 3D flow
5400.1276	authentication request could not be completed – timeout, please try again later
5400.1277	DS responded with an error, please verify request and try again
5400.1278	Authentication is expired, new InitAuth3d is required
5400.1279	3D related transaction was already used for Sale/Auth
5400.1280	Mandatory field is missing: sg_threeDSMethodNotificationURL
5400.1283	Required field sg_ThreeDSPlatformType is missing or invalid
5400.1290	Transaction could not proceed due to the challenge result.

System Errors with HTTP Status Code 200

This section provides information about system error codes with HTTP status code 200.

A system error with HTTP status code 200 indicates a silent failure in which an API connection is successful but a background processing error occurred on the Nuvei side or with the upstream provider (the financial institution or processor).

7400 System Error with HTTP Status Code 200

A 7400 message is displayed because of a system error caused by risk/fraud errors.

Error Code	Error Message
7400.1114	Blacklisted card number.
7400.1116	Custom Fraud Screen Filter.

HTTP Status Code 400 – Bad Request

The HTTP status code ‘400 – Bad Request’ indicates that a request cannot or will not process a request because the request is considered to include a client-side error. For example, the request may be missing required parameters or have invalid formatting.

APM Errors with HTTP Status Code 400

This section provides information about APM errors with HTTP status code 400.
An APM error with HTTP status code 400 indicates that a request to a third-party provider failed because the data provided was invalid for that specific provider’s requirements.

8100 APM Errors with HTTP Status Code 400

An 8100 message is provided due to an APM error caused by APM mandatory fields.

Error Code	Error Message
8100.1268	Address field is required

Input Errors with HTTP Status Code 400

This section provides information about input error codes with HTTP status code 400.

An input error with HTTP status code 400 indicates that the gateway rejected a request before processing because the payload is structurally or logically invalid. The 400 status code indicates that the server cannot parse or accept the message due to client-side errors.

5000 Input Errors with HTTP Status Code 400

A 5000 message is provided because of an input error caused by format errors.

Error Code	Error Message
5000.1000	Invalid input / actual error message is generated during the run time.
5000.1001	Invalid expiration date.
5000.1002	Ambiguous payment data provided
5000.1003	Invalid name or code
5000.1005	Invalid date input
5000.1012	Payment Method %s does not support transaction type %s
5000.1102	Invalid card number (length).
5000.1103	Invalid card number (MOD 10).
5000.1104	Invalid CVV2.
5000.1115	Illegal BIN number.
5000.1125	Format error.
5000.1128	Invalid transaction type code.
5000.1138	Invalid credit type.
5000.1143	Country does not match ISO Code.
5000.1147	Invalid account number.
5000.1148	Invalid cheque number.
5000.1153	Invalid bank code (number of digits)
5000.1154	Invalid bank code (alpha numeric).
5000.1159	State does not match ISO Code.
5000.1160	Invalid bank code (checksum digit).
5000.1161	This bank allows only 3 digits in CVV2.
5000.1164	Invalid token.
5000.1165	Token mismatch.
5000.1166	Invalid email address.
5000.1169	sg_ResponseFormat field is not valid.
5000.1170	Version field is missing or incorrect
5000.1171	Issuing country is invalid.
5000.1172	Phone is missing or format error.
5000.1173	Cheque number is missing or incorrect.
5000.1174	Birth date format error.
5000.1175	Zip code format error.
5000.1180	Invalid start date.
5000.1181	Merchant Name is too long (>25).
5000.1188	Invalid token ID.
5000.1191	RiskOnly is supported from version 4.0.0 and above.
5000.1193	AGVOnly is supported from version 4.0.1 and above.
5000.1194	Age verification mismatch.
5000.1195	Requested acquirer is unrecognised.
5000.1197	Input data is not sufficient.
5000.1201	Invalid amount.
5000.1202	Invalid currency.
5000.1203	IBAN does not match country code.
5000.1214	Invalid FinalizationURL
5000.1552	Input parameter data type incorrect
5000.2001	Missing mandatory input parameter buyerId
5000.2030	Invalid external token provider
5000.3007	The value of field %s is expected to be %s
5000.3500	Invalid POS Parameter
5000.3502	KYC parameters error

5600 Input Errors with HTTP Status Code 400

A 5600 message is provided because of an input error caused by calculation/validation errors.

Error Code	Error Message
5600.1000	Currency conversion tolerance violation
5600.1001	Invalid payment token
5600.1004	{resource-name:(plan/subscription)} status is {status name}. Can't be changed to {requested status}
5600.1004	Payment token not related to given buyer
5600.1006	Payment not found
5600.1007	Entity is not eligible for Apple Pay Mass Enablement
5600.1025	A merchant reference already exists; it can’t be changed
5600.1029	%s is not in the list of supported values
5600.1030	Field %s is mandatory when %s = %s
5600.1032	The amount must be between %d and %d
5600.1033	openAmount.max cannot be less than openAmount.min
5600.1101	Invalid card number (alpha numeric).
5600.1105	Auth Code/Trans ID/Credit card number mismatch.
5600.1106	Credit amount exceeds total charges.
5600.1111	This transaction was charged back.
5600.1112	Sale/Settle was already credited.
5600.1135	Only one credit per sale is allowed.
5600.1150	UserID/Trans Type /Trans ID mismatch.
5600.1152	Transaction was already canceled.
5600.1167	Transaction already settled.
5600.1168	Transaction already voided.
5600.1206	Settle amount exceeds total charges
5600.1207	Duplicate check number
5600.1210	Offline-approved
5600.1285	Exceeding refund time frame
5600.1287	Void is not supported for the related transaction type
5600.1288	Void is not supported for the related transaction type in current processor
5600.1553	Currency of auto reversal does not match the currency of the settle
5600.1554	Amount of auto reversal does not match the amount of the settle and auth
5600.1555	Auto Reversal Cannot be Allowed with Multiple Settle
5600.1556	Settle amount plus AutoReversal Amount should bequal to Original Auth
5600.1557	Original currency does not match auto reversal currency
5600.1559	Cannot void auth, transaction has already been settled
5600.2000	The External token provider is not valid
5600.3001	Invalid Interval for sale reversal
5600.3002	Invalid Interval for refund reversal
5600.3003	Invalid Interval for OCT reversal
5600.3004	Transaction has been already reversed
5600.3005	Transaction is not approved
5600.3006	Transaction type does not match reversal type
5600.3007	Transaction has not been transmitted
5600.3008	Transaction already has chargeback record
5600.3021	Payment option already saved
5600.101700	Missing card or token data
5600.101701	Ambiguous card or token data

5700 Input Errors with HTTP Status Code 400

A 5700 message is provided because of an input error caused by expiration errors.

Error Code	Error Message
5700.1002	Expiration date has already passed.
5700.1108	Invalid interval between authorisation and settle.
5700.1220	Expired Token
5700.1265	One year passed since last sale, Payout declined
5700.1268	Token is inactive
5700.3019	Token usage violates token sharing policy
5700.3020	Merchant reference violates uniqueness policy

Limits Input Errors with HTTP Status Code 400

This section provides information about limits input errors with HTTP status code 400.

A limits input error with HTTP status code 400 indicates that a request is rejected because the data provided violates specific pre-defined constraints or merchant-level limited required for processing. The server understands the request but the sent values are not within the limits for a specific field or an account configuration.

5800 Limits Input Error with HTTP Status Code 400

A 5800 message is provided because of a limits input error.

Error Code	Error Message
5800.1006	Limit exceeding amount
5800.1124	Total of credits amount exceeds restriction.
5800.1126	Credit amount exceeds limit.
5800.1127	The amount exceeds the limit.
5800.1132	Amount exceeds bank limit.
5800.1137	Credit count exceeded credit card company restriction.
5800.1146	Void is not allowed due to customer credit card restriction.
5800.3005	Amount %.2f is not within %s payment method allowed amount limits of %s %s
5800.3008	The length os %s is not withing the configured limits of %s %s

Tokenization Service Errors with HTTP Status Code 400

This section provides information about tokenization service errors with HTTP status code 400.

A tokenization service error with HTTP status code 400 indicates that the server rejects a request to create, retrieve, or update a payment token because the input data is invalid or the tokenization logic is violated.

9200 Tokenization Service Errors with HTTP Status Code 400

A 9200 message provided because of a tokenization service error caused by technical tokenization service errors.

Error Code	Error Message
9200.501555	No Network token associated with this paymentTokenId

HTTP Status Code 401 – Unauthorized

The HTTP status code ‘401 – Unauthorized’ indicates that a request has invalid credentials or an invalid authorization header; as a result, the server cannot verify the identity.

Authorization Errors with HTTP Status Code 401

This section provides information about authorization errors with HTTP status code 401.

An authorization error with HTTP status code 401 indicates that the server could not verify an identity. The request is rejected because the security credentials provided are either missing, invalid, or incorrectly formatted.

5300 Authorization Errors with HTTP Status Code 401

A 5300 message is displayed because of an authorization error caused by security reasons.

Error Code	Error Message
5300.3017	Authorization Error

7300 Authorization Errors with HTTP Status Code 401

A 7300 message is displayed because of an authorization error caused by permission errors.

Error Code	Error Message
7300.1001	Cannot validate Message Authentication Code
7300.10014	APM authentication error
7300.3000	Authorization Error
7300.3001	Authorization Error

HTTP Status Code 403 – Forbidden

The HTTP status code ‘403 – Forbidden’ indicates that an action is not allowed; the server understands the request but refuses to authorize the request.

Authorization Errors with HTTP Status Code 403

This section provides information about authentication errors with HTTP status code 403.

An authorization error with HTTP status code 403 indicates that the credentials (API keys) are valid and recognized, but that the user is not permitted to perform a specific action or access a requested resource.

7500 Authorization Errors with HTTP Status Code 403

A 7500 message is provided because of an authorization error caused by blocking errors.

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

HTTP Status Code 404 – Not Found

The HTTP status code ‘404 – Not Found’ indicates that an item is not found or does not exist.

Input Errors with HTTP Status Code 404

This section provides information about input errors with HTTP status code 404.

An input error with HTTP status code 404 indicates that the gateway cannot locate a specific resource referenced in a request or that the API endpoint is incorrect; the data does not exist in the server’s records.

5900 Input Errors with HTTP Status Code 404

A 5900 message is provided because of an input error caused by missing resource errors.

Error Code	Error Message
5900.1001	Parent Entity not found
5900.1003	No configured domains found
5900.1004	Balances report is not available for this date
5900.1006	No scopes found
5900.1011	Certificate not found

System Errors with HTTP Status Code 404

This section provides information about system errors with HTTP status code 404.

A system error with HTTP status code 404 indicates a structural disconnect between a request and Nuvei infrastructure. A 404 system error suggests that a service or environment is unavailable or improperly mapped.

9100 System Errors with HTTP Status Code 404

A 9100 message is provided because of a system errors caused by onboarding errors/missing resources.

Error Code	Error Message
9100.1005	Not found

HTTP Status Code 500 – Internal Server Error

The HTTP status code ‘500 – Internal Server Error’ indicates an internal server-side error (Nuvei’s side). The server encountered an unexpected condition that prevents the server from completing a request.

APM Errors with HTTP Status Code 500

This section provides information about APM errors with HTTP status code 500.

An APM error with HTTP status code 500 indicates a server-side failure during communication between Nuvei and a third-party payment provider.

8000 APM Errors with HTTP Status Code 500

An 8000 message is provided because of an APM error caused by APM expiration.

Error Code	Error Message
8000.10010	QR Code expired
8000.1005	Expired card
8000.1033	Invalid effective date
8000.2022	Transaction expired

8300 APM Errors with HTTP Status Code 500

An 8300 message is provided because of an APM error caused by APM advanced fields.

Error Code	Error Message
8300.10001	Payment method not supported by APM connector
8300.10018	Payment method not supported
8300.1020	ACH: Mandate not found
8300.1027	ACH: Duplicate Entry
8300.1031	Mandate not Valid
8300.1032	Mandate Cancelled
8300.1034	New card issued
8300.1131	Bank is not supported
8300.1132	Process failed
8300.1133	Process canceled
8300.1193	Issuer or switch inoperative
8300.1196	Duplicate transaction
8300.1207	Duplicate check number
8300.1208	MICR error
8300.1210	Offline-approved
8300.1211	Unable to go online; offline-approved
8300.1212	Offline-declined
8300.1213	Unable to go online; offline-declined
8300.1214	Acquirer validation
8300.1217	APM not available for merchant
8300.1218	Payment not authorised by user
8300.1219	Country not supported
8300.1220	End user did not complete
8300.1222	Transaction completed but not confirmed
8300.1229	Delayed Processing
8300.1232	Rejected by customer
8300.1234	Currency conversion not supported
8300.1235	Currency conversion error
8300.1236	Not in Use
8300.1237	API Test mode
8300.1242	Credit Not Allowed
8300.1249	Different funding option required
8300.1254	Encryption error
8300.1258	No action taken
8300.1263	Force STIP
8300.2012	Correction Not Supported
8300.2016	Withdrawal Not Allowed
8300.2017	Configuration Error

8301 APM Errors with HTTP Status Code 500

An 8301 message is provided because of an APM error caused by APM reference.

Error Code	Error Message
8301.10006	Refund period exceeded the time limit
8301.10007	Requested currency is different from the original currency
8301.10008	Related Transaction Not Found
8301.10011	Authorisation code checking error
8301.10017	AMOUNT_MISMATCH
8301.1251	Invoice not found
8301.1270	Amount greater than related transaction
8301.1271	The sum of the credited amount is larger than the original debit
8301.2004	Transaction Exists
8301.2008	Invoice Not Found
8301.2011	Transaction Not Found

8500 APM Errors with HTTP Status Code 500

An 8500 message is provided because of an APM error caused by APM input.

Error Code	Error Message
8500.10000	Mandatory field is missing
8500.10002	Incorrect request parameter
8500.10004	Incorrect checksum
8500.10009	Invalid validation code
8500.10022	Card type verification error
8500.1015	ACH: Country is not supported
8500.1016	Invalid Account
8500.1017	Invalid Account Number
8500.1018	Invalid Bank Code
8500.1023	Invalid CVV2
8500.1026	ACH: Invalid Address
8500.1134	Invalid payee
8500.1142	Bank name field required
8500.1155	Invalid card Number
8500.1156	Invalid merchant
8500.1162	Invalid transaction
8500.1163	Invalid amount
8500.1167	Format error
8500.1185	Invalid account specified
8500.1189	Negative CAM, dCVV, iCVV, or CVV results
8500.1215	Missing argument
8500.1224	Amounts discrepancy
8500.1225	APM validation
8500.1228	Currency not supported
8500.1231	Invalid bank
8500.1238	Invalid ID
8500.1239	Invalid argument
8500.1240	Wrong state for action
8500.1250	Too Many Parameters
8500.1253	Invalid phone number as user account ID
8500.1262	Invalid biller information
8500.1272	Consumer info validation failed
8500.2002	Invalid Merchant Id
8500.2003	Amount Mismatch
8500.2007	Invalid Merchant Credentials
8500.2020	Invalid User Credentials

8700 APM Errors with HTTP Status Code 500

An 8700 message provided because of an APM error caused by the APM system.

Error Code	Error Message
8700.1004	Timeout/Retry
8700.1128	External Error In Processing
8700.1130	Transaction Data Check Failed
8700.1187	System not available
8700.1194	Routing error
8700.1195	Transaction cannot be completed
8700.1209	Too many checks (over limit)
8700.1243	DatabaseError
8700.1246	Transaction cannot be completed; violation of law
8700.1247	Login Failed
8700.1257	System Error
8700.2010	Unknown Error
8700.2018	Technical Error
8700.2019	Payment method Technical Error
8700.2021	Merchant account problem

8900 APM Errors with HTTP Status Code 500

An 8900 message provided because of an APM error caused by the APM in general.

Error Code	Error Message
8900.10020	Encryption is not configured
8900.10021	Data could not be decrypted
8900.1012	ACH Processor Unknown Response
8900.1245	APM maintenance

8901 APM Errors with HTTP Status Code 500

An 8901 message provided because of an APM error caused by the APM account.

Error Code	Error Message
8901.10012	Soft Decline - Authentication is Advised
8901.10024	Invalid card status – status is other than active
8901.1009	Account is blocked
8901.1030	Account Closed
8901.1223	Account locked
8901.1244	Terms and conditions not accepted
8901.1259	No current account
8901.1260	Transaction does not fulfil AML requirement
8901.1269	Refusal due to regulatory reasons
8901.2009	Authentication Error
8901.2023	User account problem

8902 APM Errors with HTTP Status Code 500

An 8902 message provided because of an APM error caused by APM limits.

Error Code	Error Message
8902.1177	Exceeds withdrawal limit
8902.1205	Amount greater than established limit
8902.1216	API call was rate limited.
8902.1221	Receiving Limit exceeded
8902.1230	Exceeds transaction limit
8902.1252	Payment amount is less than the limit
8902.2005	Deposit Minimum
8902.2006	Deposit Maximum
8902.2013	Withdraw Minimum
8902.2014	Withdraw Maximum
8902.9998	SL: Above max transaction limit

8903 APM Errors with HTTP Status Code 500

An 8903 message provided because of an APM error caused by APM security.

Error Code	Error Message
8903.10014	Custom fraud screen filter
8903.10019	PIN Code is required
8903.10023	Terminal not authenticated
8903.1264	Unsafe PIN
8903.1267	CANNOT LOGIN

8904 APM Errors with HTTP Status Code 500

An 8904 message provided because of an APM error caused by APM timeout.

Error Code	Error Message
8904.10005	APM timeout

APM Decline Statuses with HTTP Status Code 500

This section provides information about APM decline statuses with HTTP status code 500.

An APM decline status with HTTP status code 500 indicates a specific type of failure in which a transaction is rejected by an APM provider but the rejection causes an unhandled error or timeout during the status update to Nuvei. The HTTP status code 500 suggests a decline in which the system disconnected at the time of the refusal.

8400 Decline Statuses with HTTP Status Code 500

An 8400 message is provided because of an APM decline caused by an APM provider generic decline.

Decline Status Code	Decline Status Message
8400.1001	Referral
8400.1002	Call issuer
8400.1164	No such issuer
8400.1174	Transaction not permitted to cardholder
8400.1248	Payment Denied
8400.9999	Generic Decline

8401 Decline Statuses with HTTP Status Code 500

An 8401 message is provided because of an APM decline caused by APM insufficient funds.

Decline Status Code	Decline Status Message
8401.1000	Decline
8401.10013	Declined
8401.1008	ACH: Decline
8401.1150	Insufficient funds
8401.1158	Do not honor
8401.1241	Consumer Cannot Pay
8401.2015	Insufficient Funds

8402 Decline Statuses with HTTP Status Code 500

An 8402 message is provided because of an APM decline caused by APM general decline.

Decline Status Code	Decline Status Message
8402.10016	Default

8800 Decline Statuses with HTTP Status Code 500

An 8800 message is provided because of a decline caused by APM risk.

Decline Status Code	Decline Status Message
8800.10003	Illegal IP address
8800.1003	Lost/Stolen
8800.1006	Blacklisted by the bank
8800.1025	ACH: Rejected by the bank risk management
8800.1159	Pick up card, special condition (fraud account)
8800.1169	Lost card, pickup
8800.1170	Stolen card, pickup
8800.1176	Suspected fraud
8800.1206	Unpaid items, failed negative file check
8800.1226	Blacklisted by APM
8800.1227	Blocked bank code
8800.1233	Restricted card/bank account
8800.1255	Sender IP address blocked
8800.1256	The payer’s name is incorrect.
8800.1261	Blocked, first used
8800.1273	AVS Failed

Input Errors with HTTP Status Code 500

This section provides information about input errors with HTTP status code 500.

An input error with HTTP status code 500 indicates a critical failure in the validation engine. The HTTP status code 500 suggests that the data may have caused the server to crash or to encounter an unhandled exception.

5500 Input Errors with HTTP Status Code 500

A 5500 message is provided because of an input error caused by reference errors.

Error Code	Error Message
5500.1000	Potential Loop detected
5500.1003	input {resource-name:(plan/subscription)} not found
5500.1015	Transaction cannot be voided
5500.1016	Payment is not in status fingerprint
5500.1017	Payment is not in status challenge
5500.1023	Buyer is not in valid state
5500.1024	Payment cannot be performed. Payment Token is not in active state
5500.1032	Invalid Temporary Payment Token
5500.1149	Account Number/Trans ID mismatch.
5500.1151	Transaction does not exist in the rebill system.
5500.1189	Invalid reference
5500.1289	Issuer data is not available, please try again later
5500.3013	Payment Token not found
5500.3016	Buyer not found

System Errors with HTTP Status Code 500

This section provides information about system errors with HTTP status code 500.

A system error with HTTP status code 500 indicates a generic response resulting from the server’s encounter of an unexpected condition that prevents the server from completing a valid request. The HTTP status code 500 suggests a failure on the Nuvei side; the request was probably formatted correctly but the backend system disconnected during execution.

7000 System Errors with HTTP Status Code 500

A 7000 message is displayed because of a system error caused by general errors.

Error Code	Error Message
7000.1000	Internal system error
7000.1001	Currency conversion rate not found
7000.1002	Apple Pay Mass Enablement is currently unavailable
7000.1003	Transaction processing error
7000.1004	Error fetching transaction details
7000.1031	Error creating Temporary Payment Token
7000.1129	General filter error.
7000.1134	AVS processor error.
7000.1190	Risk processor error.
7000.1192	AGV processor error.
7000.1205	APM risk processor error.
7000.2001	The requested acquirer bank is temporarily unavailable.
7000.2003	Error in Decryption - Decryption can't be performed
7000.2006	Error opening payment session: %s

7100 System Errors with HTTP Status Code 500

A 7100 message is displayed because of a system error caused by communication errors.

Error Code	Error Message
7100.1000	Communication error
7100.1001	Balance is currently unavailable
7100.1203	Timeout/Retry
7100.101702	Communication error in installment handling

7200 System Errors with HTTP Status Code 500

A 7200 message is displayed because of a system error caused by credential errors.

Error Code	Error Message
7200.1001	Cannot generate Message Authenticatioon Code

9000 System Errors with HTTP Status Code 500

A 9000 message is displayed because of a system error caused by onboarding errors.

Error Code	Error Message
9000.1002	Can’t delete the gatewayAccount configuration. There is at least one processingEntity which uses the gatewayAccount. configuration
9000.1002	Can’t delete the gateway configuration. There is at least one authorizationEntity which uses the gateway configuration.
9000.1002	Can’t update the gateway type. There is at least one authorizationEntity which uses the gateway configuration.
9000.1002	Can’t delete the entity configuration. There is at least one transaction for it.
9000.1005	Can’t delete the gateway configuration. There is at least one Entity which uses the gateway configuration
9000.1027	Can't update the payment token uniqueness policy. There are payment tokens related to the entityId given.