Errors may occur at several different points in the payment system. Depending on where and why the error happened, you may need to retry the transaction at a later time and/or contact your client to have them call the card issuer (the bank that issued them the card).
Most of the errors you will encounter will be from processing payments. You will always get a code and a description. The code is a short description given by the issuing bank, and is most cases is not helpful. We have included a human-readable description that says what the error was, possible reasons why it happened, and what to do about it.
There are two categories of errors:
Errors Returned From Failed Payments
Code | Description |
generic decline | The transaction was declined. No specific reason was given. |
invalid amount | The transaction was declined because the amount exceeded the account's approval limit. |
insufficient funds | The transaction was declined due to insufficient funds. |
unavailable | The transaction was declined because the processing network is currently unavailable. Please try again later, or have your client contact the card issuer if the issue persists. |
issuer not available | The transaction was declined because the issuing bank is not currently available. Please try again later, or have your client contact the card issuer if the issue persists. |
reenter transaction | The transaction was declined, as the payment processor is unable to process the transaction as it was presented. Double-check the fields to ensure that the information is accurate, then try again. If the issue persists, have your client contact the card issuer. |
call issuer | The transaction was declined by the card issuer, who requests that you call them before retrying the transaction. |
unauthorized | The transaction was declined because your company is not set up to process transactions under the Integrated Illness and Injury Services (IIAS) system. Please contact the card issue for more information. |
processing error | The transaction was declined because the card issuer's system encountered an error processing this transaction. Please try again later or have your client contact the card issuer if the issue persists. |
restricted card | The transaction was declined because the card being used for the transaction has specific limitations or restrictions imposed by the card issuer. These restrictions prevent it from being used for certain types of transactions. Common reasons for this error include geographic location, merchant restrictions, usage limits, or the card is blocked. have your client contact the card issuer for more information. |
generic decline | The transaction was declined because the card being used is not currently active. For example, the card may need to be activated, the card may be expired, or the account may be closed. This can also happen when the card is frozen due to fraud alerts. have your client contact the card issuer for more information. |
transaction not allowed | The transaction was declined because the transaction been flagged by the card issuer or payment processor as violating legal or regulatory guidelines. have your client contact the card issuer for more information. |
duplicate transaction | The transaction was declined because the transaction details (including the amount, card number, and merchant) have been submitted more than once within a short time frame, leading the processor to flag it as a duplicate. If this is not a duplicate transaction, please try again later. |
processing error | The transaction was declined because there was an unexpected issue within the payment processing system preventing the transaction from being completed. Please try the transaction later, or contact Support if the issue persists. |
processing error | The transaction was declined because there was an unexpected issue within the payment processing system preventing the transaction from being completed. Please try the transaction later, or contact Support if the issue persists. |
lost card | The transaction was declined because the card was reported as lost to the card issuer. have your client contact the card issuer for more information. |
expired card | The transaction was declined because the card is expired. Please remove this payment method. |
restricted card | The transaction was declined because the card has specific limitations or restrictions imposed by the card issuer. have your client contact the card issuer for more information. |
invalid account | The transaction was declined because the payment processor is unable to recognize or find the issuing bank associated with the credit or debit card being used for the transaction. have your client contact the card issuer for more information. |
unauthorized | The transaction was declined because the card is not allowed to be charged at a terminal. Please contact Support for more information. |
not permitted | The transaction was declined because the cardholder is attempting to perform a transaction that is not allowed under the terms and conditions set by the card issuer. have your client contact the card issuer for more information. |
revocation of authorization | The transaction was declined because the Cardholder has requested that recurring or installment payments be stopped. Please contact the cardholder. |
do not honor | The transaction was declined because the card issuer has requested that we not honor this transaction. have your client contact the card issuer for more information. |
approve with id | The transaction was declined because the card issuer requests positive identification from the cardholder. Contact the card issuer for more information. |
generic decline | The transaction was declined because the processing network issued an error. Try again later or contact Support if the issue persists. |
nsf | The transaction was declined because the primary funding source failed. Please contact the cardholder. |
generic decline | The transaction was soft declined. This error is usually a temporary decline due to insufficient funds, transaction limits, network issues or fraud alerts. Retry the transaction later or contact the card issuer if the problem continues. |
processing error | The transaction was declined because of a processing error with the Vantiv network. Please try again later, or contact Support if the issue persists. |
generic decline | The transaction was declined by the card issuer. Please try again later or contact the card issuer if the problem continues. |
Errors Returned from General Use
Code | Description |
3ds disabled | Payment was declined because the 3D Secure system is disabled. Please call the card issuer for more information. |
3ds authentication successful | Payment was accepted by the 3D Secure system. |
3ds authentication invalid | Payment was declined due to an invalid 3D Secure code. Please call the card issuer for more information. |
3ds authentication failed | Payment was declined due to an failed 3D Secure authentication. Please call the card issuer for more information. |
3ds authentication not validated | Payment was declined because 3D Secure authentication could not be validated. Please call the card issuer for more information. |
account return error | An attempt to use a bank account failed because there is an issue with the account. |
action already set | This error message means that when trying to update or change a "hold" action (which might be something like putting a temporary hold on the funds or changing the status of a payment), the system found that the hold action was already set to what you were trying to change it to. In other words, you're trying to apply a change that's already been done, so the system doesn’t need to do anything and is flagging it as unnecessary. |
address match zip mismatch | The address matches the one on record for this payment method, but the zip or postal code does not match. |
allow partial disabled | A transaction which received a partial approval from the issuer failed because the allowPartial indicator is set to not allow partial approvals. |
amex disabled | An attempt to use an American Express card failed because American Express is not enabled for your account. |
amount exceeds source | An attempt to reserve a source of funds failed because the total reserve desired exceeds the total of the source of funds. |
batch closed | This transaction could not be added right now because the processing batch for the day is closed. Please try the transaction later. |
batch error | This transaction could not be added to the current batch. Please contact Support for assistance. |
batch platform mismatch | This transaction could not be added to the current batch because the transaction platform does not match the current batch's platform. Please contact Support for assistance. |
boarding disabled | We could not onboard you because boarding is currently disabled. Please contact Support for assistance. |
call issuer | This transaction could not be processed. The card issuer requests that you call them before retrying the transaction. |
card not supported | The transaction could not be processed because private label cards are not supported. |
chargeback closed | Could not change the chargeback's status because the chargeback has been closed. |
connection error | There was an issue connecting to the card processor. Try again later, or contact Support if this issue continues. |
create error | There was an unspecified issue creating this resource [RESOURCE]. |
daily limit exceeded | This transaction failed because it exceeds your daily transaction rate limit. |
daily total exceeded | This transaction failed because it exceeds your daily transaction amount limit. |
declined | The transaction was declined. No specific reason was given. |
delete error | Failed to delete this resource due to unspecified circumstances. |
delete restricted | Failed to delete this resource because the record restricts deletion. |
discover disabled | An attempt to use a Discover card failed because Discover is not enabled for your account. |
do not honor | The card issuer has requested that we not honor this transaction. Please contact the card issuer more information. |
duplicate file | An attempt to upload a file failed because a file already exists for that record. |
duplicate record | The record failed to save because the system considers it a duplicate. |
duplicate referenced record | The record failed to save because the system considers it a duplicate. |
duplicate transaction | This transaction failed because it is a duplicate of an existing transaction. |
echeck disabled | This transaction failed because eCheck is not enabled on your account. Please contact Support to enable eCheck transaction processing. |
email confirmation pending | An attempt to save a record failed because the user's email address is not yet confirmed. |
entity cannot take fees | An attempt to create a fee failed because the entity referenced may not take fees. |
entry missing fromentity | An attempt to refund a fee failed because the referenced entry's fromentity is not set. |
exclusive fields | An attempt to save a record failed because the more than one field of a set of exclusive fields were set [FIELD]. |
expected negative | An attempt to save a record failed because the amount was positive and a negative amount was expected. |
expected positive | An attempt to save a record failed because the amount was negative and a positive amount was expected. |
expected total mismatch | An attempt to save an invoice failed because the total on the invoice does not match the aggregate total of it's line items. |
expiration invalid for payment method | The expiration date provided for the card being used for a transaction is not valid or acceptable for the specific payment method being attempted. This could happen if the expiration date is incorrect, the card is expired, a new card has been issued with the same account number but a new expiration date, or for fraud protection measures. |
expired card | This card is expired. |
field restricted | An attempt to save a record failed because a restricted field was set [FIELD]. |
funding currency error | This transaction failed because the funding currency is not supported. Only USD and CAD are supported at this time. |
funding disabled | Save failed because funding is disabled. |
general | An unspecified error or decline occurred. |
generic decline | Customer Cancel |
generic error | An unspecified error or decline occurred. |
incorrect cvv | The CVV for this payment method does not match the value on the card. |
incorrect pin | The PIN for this payment method does not match the value saved with the issuer. |
insufficient funds | Insufficient Funds |
internal error | An internal error occurred. Please try again or contact Support if the issue continues. |
invalid account | The account number for this payment method is not valid. |
invalid account for same day | An attempt to save a payout record failed because the account specified is a debit card which does not support sameDay. |
invalid amount | Exceeds Approval Amount Limit |
invalid auth | Authentication failed. |
invalid base64 image | The image upload failed because we are expecting a base64-formatted image. |
invalid bin | Payment method failed because there is an invalid batch identification number (BIN). |
invalid capture | An attempt to capture a prior authorization failed because it is no longer valid. |
invalid card number | An attempt to save a method of payment failed because the account number was invalid. |
invalid characters | An attempt to save a record failed because it contained invalid characters [FIELD]. |
invalid currency | An attempt to save a record failed because it contained an invalid currency identifier [FIELD]. |
invalid cvv | The CVV2/CID number for this payment method is invalid. |
invalid date | An attempt to save a record failed because it contained an invalid date [FIELD]. |
invalid email | An attempt to save a record failed because it contained an invalid email [FIELD]. |
invalid enum value | An attempt to save a record failed because it contained an invalid enumeration value [FIELD]. |
invalid fund | An attempt to reserve funds failed because the fund specified was invalid [FIELD]. |
invalid hostname | An attempt to save a record failed because it contained an invalid host name [FIELD]. |
invalid ip | An attempt to save a record failed because it contained an invalid IP address [FIELD]. |
invalid json | An attempt to save a record failed because it contained an invalid JSON string [FIELD]. |
invalid ksn | An attempt to save a method of payment failed because the KSN (key serial number) supplied was invalid [FIELD]. |
invalid length | An attempt to save a record failed because the character length was invalid [FIELD]. |
invalid maximum value | An attempt to save a record failed because it contained a numeric value that exceeded the maximum [FIELD]. |
invalid minimum value | An attempt to save a record failed because it contained a numeric value below the minimum [FIELD]. |
invalid non scalar | An attempt to save a record failed because it contained an invalid, non-scalar value [FIELD]. |
invalid not present | The security code did not match the code on file. |
invalid pin | The PIN code is invalid. |
invalid primary account | An attempt to set the primary account failed because a debit card is set as the method of payment. |
invalid range | An attempt to save a record failed because the value did not fall within the range of allowable values. |
invalid refund | An attempt to refund a prior sale failed because it can no longer be refunded. |
invalid relationship | An attempt to save a record failed because it contained an invalid reference [FIELD]. |
invalid relative value | An attempt to save a record failed because it contained values that were relatively invalid [FIELD]. |
invalid request | Request structure was invalid [FIELD]. |
invalid resource | The resource specified was invalid [FIELD]. |
invalid resubmission for approved txn | A transaction creation attempt copying a prior transaction failed because the copyReason specified was invalid. |
invalid retries | An attempt to save an alert failed because the specified retries was invalid. |
invalid reverse auth | An attempt to reverse a prior authorization failed because it can no longer be reversed. |
invalid routing | An attempt to save a bank account failed because the supplied routing number was invalid. |
invalid sole proprietor | An attempt to save the member or entity record failed because the ownership specified was invalid for a sole proprietor. |
invalid status | There was an error because the status transition specific is not allowed [FIELD]. |
invalid url | The requested URL was invalid. |
invalid value | An attempt to save a record failed because the supplied value was invalid [FIELD]. |
invalid xml | The XML supplied was invalid. |
invoice cancelled | An attempt to pay an invoice failed because the invoice was cancelled. |
invoice expired | An attempt to pay an invoice failed because the invoice has expired. |
invoice line items required | An attempt to email an invoice failed because there are no line items specified. |
invoice paid | An attempt to pay an invoice failed because the invoice was paid. |
ip restricted | The requested IP was a restricted IP [FIELD]. |
issuer not available | The issuer specified is not available. |
login forlogin match error | An attempt to save a messageThread record failed because the sender and receiver are the same. |
lost card | Lost/Stolen Card |
match | CVV match confirmed |
max teams exceeded | An attempt to create a teamLogin record failed because the rate limit has been reached. |
mc instant funding disabled | An attempt to save a payout record with a MasterCard debit card failed because it is disabled. |
merchant not boarded | An attempt to save a record failed because the merchant's status is not set to boarded and the record requires a boarded merchant. |
message format error | Message Format Error |
mismatch | There is a mismatch between the specified security code and the code on file. |
mismatched currency txns | A transaction creation attempt failed because the referenced transaction currency does not match. |
mismatched txns | A transaction creation attempt failed because the referenced transaction type does not match. |
missing merchant details | A transaction creation attempt failed because the merchant configuration is not complete. Please wait until you get notification that you have been fully onboarded to run transactions. |
missing to account | No 'To' Account Specified |
monthly limit exceeded | A transaction creation attempt failed because it exceeds the merchant's monthly rate limit. |
monthly total exceeded | A transaction creation attempt failed because it exceeds the merchant's monthly total limit. |
negative reserve | An attempt to reserve funds failed because the amount specified was negative. |
no amount remaining | An attempt to reserve funds failed because no amount remains on the source funds. |
no apikey param | An attempt to save a record or retrieve an invoice failed because the apiKey invoiceParameter is missing. |
no https | An attempt to save an alertAction failed because the value is missing the HTTPS prefix. |
no such code | The specified code does not exist [FIELD]. |
no such file | The requested file does not exist [FIELD]. |
no such record | The specified record does not exist [FIELD]. |
no such user | The specified user does not exist [FIELD]. |
no txn fee remaining | An attempt to save a record failed because the transaction's fee has been depleted. |
not performed | AVS not available |
not permitted | This transaction is not permitted. Please call your card issuer for more information. |
not processed | This transaction was not processed, because security code checking is currently unavailable. Please try later or contact Support if the issue persists. |
not supported | This transaction was not processed, because security code checking is not supported. |
nsf | Insufficient Funds |
only one file | An attempt to upload a file failed because more than one file was uploaded and only one is allowed. |
ownership invalid for government entity | An attempt to save a member failed because ownership was set for a Government type entity. |
parent decision required | An attempt to save a decisionAction failed because the referenced decision is not a top-level decision. |
password complexity error | An attempt to save a new password failed because it does not comply with complexity requirements. |
password history error | An attempt to save a new password failed because it matches a recently used password. |
password length error | An attempt to save a new password failed because it does not comply with length requirements. |
payment method not allowed | A transaction creation attempt failed because the requested payment method was not allowed. |
payment method not supported | A transaction creation attempt failed because the requested payment method was not supported. |
pending account verification | An attempt to save a payout failed because the bank account requires verification. |
pickup card | The card being used for the transaction has been flagged for retrieval by the merchant. This usually means that the card is no longer valid or there’s an issue with the account. |
pin try exceeded | Allowable Number of PIN Tries Exceeded |
platform error | The processing platform returned an error for the desired action. |
processing error | System Error |
query error | The requested query structure was invalid. |
record change disabled | An attempt to save a record failed because record change is disabled for this record. |
recursion error | The request structure contained too much nesting and failed. |
required field | An attempt to save a record failed because a required field was left unset [FIELD]. |
required field list | An attempt to save a record failed because one of a set of fields is required and all were left unset [FIELD]. |
reserve error | An attempt to reserve funds failed. |
restricted card | The card being used for the transaction has specific limitations or restrictions imposed by the card issuer. These restrictions prevent it from being used for certain types of transactions. Common reasons for this error include geographic location, merchant restrictions, usage limits, or the card is blocked. |
revocation of authorization | Cardholder requested that recurring or installment payment be stopped |
same day payouts disabled | An attempt to save a same day payout failed because same day payouts are disabled. |
security violation | The AMEX 4-digit code does not match the code on the card. |
service not allowed | This payment method may not be used for the service being provided. |
stolen card | This card has been reported as stolen. Please call the issuer immediately. |
ticket limit exceeded | the transaction has been declined because it exceeds the allowable limit for a single transaction (referred to as a "ticket"). This can happen due to the following reasons: a daily maximum transaction limit has been exceeded; the limit for an individual transaction has been exceeded; the transaction is unusually large compared to typical spending patterns, issuing a fraud alert. |
too many decision levels | The payments system has a limit to the number of approval steps (fraud, verification, risk assessment, etc.), and this transaction has exceeded that limit. |
total ownership insufficient | An attempt to board a merchant failed because the total ownership of its members was insufficient. |
track format error | A transaction creation attempt failed because the track data was invalid. |
transaction not allowed | The daily card limit for this card has been exceeded. Please try again tomorrow. |
txn limit exceeded | The daily transaction limit for this card has been exceeded. Please try again tomorrow. |
txn minimum threshold | The transaction failed because the transaction is below the minimum amount specified by the card issuer. |
txn type payment method mismatch | The transaction failed because the method of payment is not allowed for the transaction type requested. |
unauthorized | Transaction not allowed at terminal |
unavailable | The processing network is currently unavailable. Please try again later, or contact Support if this issue persists. |
update error | An update attempt failed due to unspecified circumstances. |
update restricted | An update attempt failed because this record restricts updating. |
validation error | An attempt to save a record failed due to an unspecified validation error. |
vendor fees disabled | An attempt to save a fee failed for a vendor because vendor fees are disabled. |
visa instant payouts disabled | An attempt to save a payout failed because instant Visa payouts are disabled. |
withdrawal limit exceeded | This transaction exceeds the withdrawal limit for this payment method. |
zip match address mismatch | The zip or postal code matched, but the street address does not. |
zip match address not verified | The zip or postal code matches, but the street address could not be verified. |