Skip to main content
All CollectionsOutlaw Payments
Outlaw Payments Error Messages
Outlaw Payments Error Messages

Want to know more about the error you received while running a payment? All error messages are listed and explained here!

Updated over 2 months ago

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.

Did this answer your question?