Error Codes

xErrorCode within API docs

Gateway errors

These errors come from the Sola gateway when the request is invalid or something is misconfigured. Use the table below to understand the error and how to resolve it.

Error Code	Message	What It Means	How to Fix
01727	Specified Token Not Found (SUT)	The provided SUT is invalid. This usually occurs if the token has already been used.	Ensure each SUT is used only once and generate a new one for every request.
01208	Specified Key Not Found Specified Key Not Found (SUT)	The xKey or iFields key provided is invalid. This can happen if the key is incomplete or has been modified.	Make sure you are using the full, unmodified key exactly as provided.
99999	Signature Invalid (SUT)	The SUT is invalid, often because the data was altered or not fully included.	Send the full, unmodified SUT exactly as returned.
01222	Unauthorized Token (V) Unauthorized Token (I) (SUT)	The Vendor ID or iFields key is invalid. This usually occurs if the Vendor ID is incorrect or the iFields key belongs to a different account than the xKey.	Verify that the Vendor ID is correct and that the iFields key and xKey belong to the same account.
01473	Card Or Magstripe Required	The request is missing card information.	Ensure that a card number, SUT, or token is included in the transaction request.

Bank Declines

These declines come directly from the cardholder’s bank and usually need to be resolved by the cardholder with their issuing bank. In rare cases, the issue may be on Sola’s side, or we may be able to provide additional guidance. If you suspect this, please reach out to our support team.

Error Code	Message
09999	Undefined Error
01000	Missing Required Variable
01001	Missing Required Tags
01002	Missing Required Fields
01010	Unable to verify card ID number.
01011	Customer Name Required
01012	More Than One Record Matches PTRANNUM; Please Use TTID
01013	AVSCode is required
01014	Bad Cardholder Account Information
01015	Invalid Issuing Bank
01016	CVV Required
01017	Invalid Street
01018	Unknown Error From Host
01019	Shipping_Information_Required
01020	Bank Not On File
01021	Exceeds Amount Limit
01022	Pin Required (EBT)
01023	Refund not permitted
01024	Security Voilation
01025	Invalid_Version
01026	Unmatched Return Not Allowed
01027	Void Rejected
01028	Must Allow Partial Auth
01029	AuthCode Required
01031	Batch Error
01032	Unable to parse response
01033	No Such Issuer
01035	Authonly not allowed on Debit/EBT transaction
01036	Lookup status not supported
01037	Adjustment Error
01038	Transaction Type Not Voidable
01040	Command Type Not Supported for Debit
01041	Incremental Auths Not Supported
01042	Connection Timeout
01043	No Original
01044	A capture requires that the existing transaction be an auth
01045	The original transaction cannot have this operation performed on it at this time
01046	Disconnect before response
01048	Revocation Auth
00104	Login failed. The login is from an untrusted domain and cannot be used with Windows authentication
01050	Account: Invalid Length
01051	Transaction type not allowed from this source
01052	No Account
01054	Processing Institution Does Not Support That Transaction Type
01055	Bank Unavailable
01057	Pin XLate Error
01058	Merchant number does not relate to a defined bank or financial institution
01059	Auth Prohibited
01060	Partial Refund Not Allowed
01062	The sum of unit and qty minus disc plus freight plus duty plus tax must equal transaction amount
01063	Original Transaction Not Approved
01064	Unable to connect to remote server
01066	The underlying connection was closed
01067	Credits are not enabled
01070	Transaction type is not voidable. Issue refund instead.
01072	Routing: Invalid Value
01073	Account: Invalid Value
01075	Card Must Be Swiped
01076	AVS CV2 Declined
01078	Authentication Error
01080	Command Not Supported
01082	Login Failed
01083	Issuer Unavailable
01084	Account Not Issued
01085	Refused
01086	Velocity Exception
01087	Invalid Data
01088	An error occurred while receiving the HTTP response
01089	Remote Server Error
01090	Unable to connect to the remote server
01092	Engine Required
01093	No checking account
01094	Invalid CC Account Number
01095	Terminal not identified or inactive
01096	This terminal or user id is not permitted to process this transaction type.
01097	Connection Error
01098	Host Connection Error
01099	Unknown Transaction Type
01100	Transaction Not Found
01102	Payment Initiative Not Supported
01103	CheckNum Invalid Value
01105	Unable to Auth
01106	Valid Auth Not Found
01110	Gift Issuance not allowed for this location
01112	Invalid Gift Card
01113	Invalid GiftCard Magstripe
01114	Account Already Issued
01115	Invalid Set ID
01116	cannot modify transaction during settlement
01117	Invalid data in Settlement Transaction Detail message
01118	Reference Number Not Supported
01119	Transaction is in a state that cannot be refunded
01120	Transaction already refunded
01121	Transaction not eligible for refund.
01122	The transaction ID is invalid for this transaction type
01123	Capture Not Supported
01124	Max refund amount exceeded
01125	TAX MUST BE >= 0.00 AND <= AMOUNT
01126	Invalid Order Amount (MIN)
01127	Invalid Order Amount (MAX)
01128	The provided Order has no lines in On Hold status
01130	None of the order lines specified could be updated to the specified reason.
01132	An error occurred while updating the entries
01135	Unable to retrieve expiration date
01137	CVV2 check cannot be performed as no data was supplied in the authorization request.
01138	The cc payment type and/or currency is not accepted
01140	Name On Account Required.
01141	Pin code required for credit/void
01145	This account has not been given the permission(s) required for this request.
01150	Exceeds Count Limit
01151	Refunds cannot be performed until the transaction has settled
01152	The server is temporarily unavailable. Please try back shortly.
01153	Backend DB Error
01154	You have tried this card too many times
01155	No Credit Account
01160	Revk Pay Ordered
01161	Stop Pay Ordered
01165	Invalid Null Account Number Last Four
01167	UserName not recognized
01170	Phone Field Required
01171	Country Field Required
01172	Email Field Required
01175	Input String was not in a correct format
01179	Authenticate Failed
01180	Lookup Failed
01182	Balance Temoporarily Unavailable
01184	Network Error
01185	No Reply
01187	Merchant has been deactivated
01188	Funds can not be released for this transaction
01189	Incorrect Device Encryption
01190	Bad MID
01191	Host Drop
01192	No Response
01193	Transaction Count Exceeded Limit
01194	Amount exceeds original transaction amount.
01195	Processor returned an invalid authorization code
01196	Zip Required for Keyed Transaction
01197	Unable to connect to TSYS
01198	Processing Error Please Try Again
01199	Server Error
01200	Unable To Create Transaction. Please Contact Support.
01201	Refund amount exceeds sale amount
01202	Credit amount exceeds sale amount
01203	Amount Required
01204	Invalid Token
01205	Invalid Zip
01206	Invalid_Pin
01207	License Required
01209	Activity Limit Exceeded
01210	Over Pin Limit
01211	Negative amount not allowed
01212	Swiping Not Allowed. Contact Support
01213	Invalid Action
01214	Unsupported Cardtype
01215	Not Authorized
01217	Account is inactive
01218	Unrecognized Trackdata Format
01220	Duplicate Keys Found
01221	Invalid GiftCard Number
01223	Card Number was not between 13 and 16 digits
01224	Original transaction not specified
01225	Pin Pad Error
01226	Invalid_Command
01227	Auth Declined
01228	Record Not Found
01230	Transaction Not Permitted
01231	OrderNumber is required
01232	Transaction Already Settled
01233	Account Required
01234	Eligible transaction not found
01235	Missing CardCVV
01236	Account Not Found
01237	Terminal ID Error
01238	PIN Retries Exceeded
01239	Invalid Credentials
01240	Invalid Share Group.
01241	GiftCard Already Exists
01242	Routing: Invalid Length
01243	Internal Error
01244	Credit Not Allowed
01245	Refund Not Allowed
01246	Void Not Allowed
01247	Transaction Not Allowed
01248	Order has already been imported
01249	Edit Error
01251	Card Expired
01253	Unable to locate transaction
01254	Req exceeds bal
01255	The request was aborted: Could not create SSL/TLS secure channel.
01257	Transaction amount exceeds limit
01258	Connection Failed: Possible Setup Error
01259	Stop Recurring
01260	Bad SE Number
01261	Type Not Supported
01262	Merchant does not support this card type
01264	Unable to verify card ID number
01265	Settlement Error
01266	Limit Exceeded
01267	Invalid AuthCode
01269	Invalid Software
01270	No Open Batches Found
01271	Billing_Information_Required
01272	Card Fraud
01273	Line item total must equal amount
01274	AMEXSE merchant parameter not provided
01275	Invalid Routing Number
01277	SEC Violation
01278	Invalid_Routing
01279	Amount Error
01280	Cardnumber Mismatch
01286	No Phone Number Provided
01287	Invalid_CVV
01289	Invalid Website
01290	Debit Requires Track2 Data
01291	Invalid Email
01294	Invalid Exp Length
01295	Expiration Date Must Be In Future
01296	Invalid Merchant ID
01297	Invalid Terminal ID
01298	Invalid Account
01299	Invalid Account Settings
01300	Invalid Effective Date
01301	Invalid merchant key
01302	Try_Again_Later
01303	Void of activation after account activity
01304	Edit Honor
01305	Not approved
01306	Call acquirer's security
01307	Crypto box is offline
01308	Invalid Checking Account Number
01309	Accepted but not yet processed
01310	Promo location restricted
01311	Bulk activation package amount error
01312	Hard Capture; Pick Up
01313	Promotions for Internet virtual and physical cards do not match
01314	Transaction not permitted to terminal
01315	Reversal Rejected. Do not try again
01316	Bad checksum. The checksum provided is incorrect
01317	No term record on system
01318	System malfunction
01319	Internet access disabled
01320	No reason to decline
01321	Invalid status change
01323	TransArmor Service Unavailable
01324	Void/Full Reversal requests in which the Original Authorization was not found
01325	Too many transactions requested
01327	Duplicate Return
01328	Unmatched card expiry date
01329	Invalid issuer
01330	Lost card
01331	Account closed
01332	Duplicate Transaction
01333	CCV failed
01334	Decline
01335	System Error
01336	New Account Information
01337	Invalid account number
01338	Invalid Card Account
01339	Count Exceeds Limit
01340	Transaction Error
01341	Invalid EAN
01342	Target embossed card entered and Transaction count entered do not match
01343	Debit Switch Unavailable
01344	Approve VIP
01345	Violation of law
01346	Transaction destination not
01347	Expired card
01348	Already active and reloadable
01349	Already reversed
01350	Please retry
01351	Invalid account/date or sales date in future
01352	Product code(s) restricted
01353	Date of Birth Error for Check Processing
01354	Invalid State Code
01355	Incorrect PIN
01356	The authorizing network has a problem decrypting the cryptogram in the request
01357	Transaction not permitted to cardholder
01358	Store location zero not allowed
01359	Error
01360	Account on hold
01361	Approved EMV Key Load
01362	Invalid clerk
01363	Account is Purged
01364	Invalid_Amount
01365	Invalid transaction source
01366	Invalid time zone
01367	Service not allowed
01368	Card issuer timed out
01370	Bad authorization code
01371	Duplicate Reversal
01373	DUKPT: An error while processing the PIN block that is not related to the point-ofsale equipment. Contact the Help Desk for assistance 01372 Network Response indicates that Merchant ID/SE is invalid"
01377	Bad_repay_date
01378	Invalid currency
01379	Incorrect transaction version or format number for POS transactions
01380	Do not try again
01381	No account link
01382	Duplicate Completion
01383	Allowable PIN tries exceeded
01384	Bulk activation error
01385	CVV2 Declined
01386	Restricted card
01387	Incorrect location
01388	Transaction history not available
01389	Invalid terminal
01390	Totals Unavailable
01391	The DUKPT Base Derivation key is missing or incorrect in the PIN pad, or PIN key synchronization error
01392	No Savings Account
01393	Cash Back greater than total Transaction amount
01394	Refer – Call Authorization (Checks only)
01395	Password retry exceeded
01396	Currency conversion error
01397	Unknown account
01398	Max balance exceeded
01399	Honor With Authentication
01401	TransArmor Key Error
01402	Not lost or stolen
01403	Account already linked
01404	Already active
01405	Invalid transaction
01406	No transactions available/no more transactions available
01407	Debit/EBT network gateway cannot get through to the ISSUER
01409	Account locked
01410	Refer to issuer‘s special conditions
01411	Insufficent_Funds
01412	Exceeded account reloads
01413	Invalid merchant
01414	Invalid new password
01415	Request not permitted by this merchant location
01416	Request not permitted by this account
01417	Enter lesser amount
01418	Amount Too Large
01419	No phone service
01420	Unsuccessful
01421	Debit/EBT transaction count exceeds pre-determined limit in specified time/ Withdrawal limit exceeded
01422	Account not in inactive state
01423	Bad Post Date
01424	Stolen card
01426	Unable to Locate Record On File
01427	Bulk activation un-attempted error
01428	Account status is void lock
01429	Schema Validation Error
01430	No card record
01432	Pick Up Card
01433	The terminal transaction number did not match (on a void or reversal)
01434	Subsystem Unavailable
01435	New Account Information available
01436	Call for authorization
01437	Approve for partial amount
01438	Inactive account
01439	TransArmor Invalid Token or Account Number
01440	EMV Key Download Error
01441	Do not honor
01442	Referred – Skip Trace Info
01443	Balance not available (denial)
01444	Bad mag stripe
01446	Approved EMV Key Load
01447	Invalid password
01448	Exceeds withdrawal frequency limit
01449	No previous transaction
01451	Transaction not permitted to acquirer or terminal
01452	Hard Negative Info On File
01453	Account row locked
01455	Format error
01456	Exceeds withdrawal amount limit
01457	Resubmission of transaction violates debit/EBT network frequency
01458	New password required
01462	Transaction Previously Voided
01463	Invalid_RefNum
01464	Invalid Credit Card
01465	Invalid Trackdata
01466	Either Token or Magstripe or Card Num and Exp valid per transaction
01467	Refund/Void not allowed on EBT transaction
01468	Invalid EBT Card
01469	Transaction amount exceeded for test account
01470	Invalid_EXP
01471	Refund/Void not allowed on Debit transaction
01472	PIN/DUKPT Required
01474	Invalid Pin/Dukpt
01477	Expiration Date Required
01478	Invalid EBT Card Length
01479	Invalid Card
01480	Voice_Authentication_Required
01481	Timeout
01482	Billing Address Mismatch
01483	Invalid DUKPT format
01485	Account Setup Error
01486	Credit Denied
01487	Unsupported Card Type
01488	Processor temporarily unavailable
01489	Invalid CVV Length
01490	Card Number Error
01491	Invalid_CardNumber
01492	Invalid Tran Code
01493	Hold Card
01494	Use VOID to refund an unsettled transaction
01495	Invalid Variable
01496	Invalid Hash
01500	Invalid FSA Amounts
01501	Resume Map
01502	Name exceeds max length
01503	Monthly volume exceeded
01504	Transaction can not be completed, violation of law
01505	Invalid Transaction Type
01506	Unsupported AID
01507	Processing Error
01508	Invalid Store Key
01509	Invalid Integer
01510	Routing or MICR Required
01511	Account Closed - Contact Cardholder (AU)
01512	Contact Cardholder (AU)
01513	Specified source key not found.
01514	Invalid Bill Street
01515	Invalid Bill First Name
01516	Invalid Bill Last Name
01517	Invalid Ship Street
01518	Invalid Ship First Name
01519	Invalid Ship Last Name
01520	Declined (SF)
01521	MVV merchant parameter empty or invalid
01522	Unable to process transaction
01523	Transaction cannot be refunded at this time
01524	Transaction cannot be voided at this time
01525	Transaction Cannot Be Voided
01526	Specified source key not found
01530	FSA Not Supported
01531	Pin Required for EBT
01532	Account Setup error. Please Contact Support.
01533	Card or Magstripe or MemberID Required
01534	Access Denied
01535	Invalid Input
01536	Invalid Tax
01537	Sequence ID Required
01538	CVV2 Refused
01539	Transaction exceeds maximum amount.
01540	Name Required
01541	Street exceeds max length
01542	Invalid Service Code
01543	Invalid Account/Card Number.
01544	CVC2/CID Rejected by Issuer.
01545	Reversal error
01546	Invalid Name
01548	EXAMOUNT MUST BE >= 0.00 AND <= AMOUNT
01550	EMV Pin Error
01551	Ineligible Refnum
01552	Invalid PNRef
01553	Command Type Does Not Support Pin
01554	Void Not Supported For Pin Transactions
01555	Card not accepted by merchant, please try a different card
01556	Invalid Invoice
01557	Refund not permitted, original sale not found
01558	Balance Temporarily Unavailable
01559	System temporarily unavailable
01560	Issue Amount Exceeds Redeem Amount
01561	This card can not be used with MOTO transactions
01562	Current permissions do not allow this operation. Please contact customer support.
01563	Transaction amount below minimum
01564	Invalid check images
01565	Invalid Username
01566	Invalid Currency Code
01567	Invalid Account Type
01568	Invalid mInitial
01569	Invalid aptNum
01570	Invalid city
01571	Invalid state
01572	Invalid billZip
01573	Invalid mailApt
01574	Invalid mailCity
01575	Invalid mailState
01576	Invalid mailZip
01577	Invalid dayPhone
01578	Invalid evenPhone
01579	Invalid ssn
01580	Invalid dob
01581	Invalid recEmail
01582	Invalid knownAccount
01583	Invalid rtNum
01584	Invalid splitNum
01585	A ProPay account With this e-mail address already exists Or User has no AccountNumber
01586	A ProPay account With this social security number already exists
01587	The email address provided does Not correspond To a ProPay account.
01588	Recipients e-mail address shouldnt have a ProPay account And does
01589	Invalid Credential Or IP address Not allowed
01590	Over credit card use limit
01591	Miscellaneous Error
01592	Denied a ProPay account (Developer should display a descriptive message that guides a New user To fill out ProPay exceptions form And submit it.)
01593	Unauthorized service requested
01594	Account Not affiliated
01595	Duplicate invoice number (The same card was charged For the same amount With the same invoice number (including blank invoices) In a 1 minute period. Details about the original transaction are included whenever a 69 response Is returned. These details include a repeat Of the auth code, the original AVS response, And the original CVV response.)
01596	Duplicate external ID
01597	Account previously Set up, but problem affiliating it With partner
01598	The ProPay Account has already been upgraded To a Premium Account
01599	Invalid Destination Account
01600	Account Or Trans Error
01601	Money already pulled
01602	Not Premium (used only For push/pull transactions)
01603	Empty results
01604	Generic account status Error
01605	InvalidUserID
01606	BatchTransCountError
01607	InvalidBeginDate
01608	InvalidEndDate
01609	InvalidExternalID
01610	DuplicateUserID
01611	Duplicate Batch ID
01612	Duplicate Batch Transaction
01613	Batch Transaction amount Error
01614	Unavailable Tier
01615	Invalid Country Code
01616	Account created In documentary status, but still must be validated.
01617	Account created In documentary status, but still must be validated And paid For.
01618	Account created successfully, but still must be paid For.
01619	Invalid Payer Name
01620	Transaction does Not meet Date criteria
01621	Direct deposit account Not specified
01622	Invalid SEC code
01623	Invalid x509 certificate
01624	Invalid value for require CC refund
01625	Required field Is missing (This Is returned only For edit ProPay account. See response tag For field name.)
01626	Invalid EIN
01627	Invalid business legal name (DBA)
01628	One of the business legal address fields Is invalid
01629	Business (legal) city Is invalid
01630	Business (legal) state Is invalid
01631	Business (legal) zip Is invalid
01632	Business (legal) country Is invalid
01633	Mailing address invalid
01634	Business (legal) address Is invalid
01635	Incomplete business address
01636	Amount Encumbered by enhanced Spendback
01637	Invalid key serial number
01638	You may Not transfer money between these two accounts. Sponsor bank transfer disallowed.
01639	Currency code Not allowed for this transaction
01640	Currency code Not permitted for this account
01641	Requires Additional Validation
01642	Multicurrency processing Is Not allowed for the account
01643	Multicurrency processing Is Not supported For this bank processor
01644	Capture amount exceeds allowed amount
01645	Account setup does Not allow capture For amount greater than authorization
01646	Threat Metrix risk denied (no responseCode Is returned)
01647	Threat Metrix Invalid SessionId
01648	Threat Metrix Invalid Account configuration
01649	External Payment Provider Not provided
01650	External Payment Identifier Not provided
01651	External Payment Provider Not valid
01652	Inactive Or blocked MCC Code
01653	Invalid MCC Code (non-numeric Or Not In our database)
01654	Gross settle: invalid credit card information
01655	Gross settle: invalid billing information
01656	Gross settle: no billing information was included with the payment info
01657	Debit Requires Swipe. Please Swipe or Use Credit.
01658	Swipe again
01659	Key Is Inactive
01660	Invalid Void After Refund
01661	Refund on a refund not allowed
01662	Invalid Cavv/Eci Value
01663	Invalid Contactless
01664	CVV Response Code is required
01665	Invalid processor
01666	Processor is temporarily unavailable
01667	NOT AUTHORISED
01668	BIN is required
01669	Invalid license
01670	Token Expired
01671	Token reference not found
01672	Invalid EMV Read. Please try again.
01673	Inactive Gift Card
01674	Card already active
01675	Card already inactive
01678	Refund not permitted, amount exceeds original sale
01679	Declined - Contact Support
01680	Unsupported Transaction
01681	AVS Street Required
01683	Line Items Required
01684	Re enter
01685	Missing or Invalid PARes
01686	Recapture not supported
01687	You have tried too many card numbers, please contact merchant.
01689	Capture not allowed on voided auth
01690	Negative Tax amount not allowed
01691	Data Unavailable
01692	Account Unavailable
01693	This terminal has been disabled. Please contact customer service to configure the terminal.
01694	Transaction not supported
01695	Cashback not supported
01696	An unexpected error has occurred. Technical Support has been alerted to this problem.
01697	Unable to map data
01698	Invalid billing address
01699	Incorrect CVV
01700	AID Mismatch
01701	Batch previously locked for settlement
01702	Insert Card Again
01703	Card Type Not Allowed
01704	Refund not allowed; issue void
01705	Invalid RoomNum
01706	Amount Not Supported
01707	Unsupported Industry
01708	Transaction authentication required.
01709	Swipe Card
01710	Encryption Required (Port)
01711	Specified Encryption Key Not Found
01712	Debit Void Not Supported
01713	Command Type Not Supported For Debit/EBT
01714	Invalid chip read; try again.
01715	Invalid Start Date (Batch Report)
01716	Invalid Start Date/Time
01717	Swipe Not Allowed
01718	Invalid EntryMode
01719	Invalid Encryption Key
01720	Signature Invalid (SUT)
01721	Transaction can no longer be voided
01722	Invalid Encrypted Swipe
01723	One or more errors occurred
01724	The referenced transaction does not meet the criteria for issuing a credit
01725	Bill field required
01726	Invalid GiftCard Length
01728	Invalid Batch Sequence
01729	Missing Required Credit Card Data
01730	Unable to Communicate with MAPS Server
01731	Bad Data
01732	Verify Balances
01733	OOS Required
01734	Currency Not Supported
01735	Object reference not set to an instance of an object
01736	Source has been blocked from processing transactions.
01737	Invalid Field
01738	An error occurred during processing. Call Merchant Service Provider.
01739	Partial Auth not supported for eWIC
01740	This transaction cannot be accepted.
01741	Invalid eWIC card
01742	Could not Retrieve Transaction ID
01743	Missing part of path
01744	Error Processing Lookup Request Message
01745	Invoice exceeds max length. Field has been truncated.
01746	Invalid Device IP
01747	Database Unavailable
01748	Adjustment not allowed
01749	Must specify a valid payment method
01750	An error has occured. Please contact support.
01751	Try Again
01752	Batch Not Found
01753	Authentication Data Unavailable
01754	Exceeds Daily Limit
01755	Exceeds 7 Day Limit
01756	Exceeds 30 Day Limit
01757	FAILED PLZ CALL S80
01758	Transaction already settled, issue refund (P)