Transaction Error Codes & Responses

Code

Description

Code

Description

3ds_disabled

A transaction creation attempt with 3D Secure failed because 3DS is disabled.

3ds_authentication_successful

3DS authentication successful

3ds_authentication_invalid

3DS authentication is invalid

3ds_authentication_failed

3DS authentication failed

3ds_authentication_not_validated

3DS authentication not validated

account_return_error

An attempt to use a bank account failed due to its return status. Example: creating a payout with a bank account that returned as unauthorized previously for this merchant.

action_already_set

An attempt to update the hold action with a note failed due to the hold action already being set to the desired action.

address_match_zip_mismatch

Partial match: street address matches, zip 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 due to its being disabled.

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

An attempt to add a transaction to the merchant's batch failed because the batch is closed.

batch_error

An attempt to add a transaction to the merchant's batch failed.

batch_platform_mismatch

An attempt to add a transaction to the merchant's batch failed because the transaction platform does not match the batch's platform.

boarding_disabled

An attempt to board a merchant for processing failed because boarding is disabled.

call_issuer

Call Issuer

card_not_supported

Private Label Card not supported

chargeback_closed

An attempt to change the chargeback's status has failed because the chargeback is closed.

connection_error

An attempt to connect to an external processor failed.

create_error

A creation attempt failed due to unspecified circumstances.

daily_limit_exceeded

A transaction creation attempt failed because it exceeds the merchant's daily rate limit.

daily_total_exceeded

A transaction creation attempt failed because it exceeds the merchant's daily total limit.

declined

Declined

delete_error

A deletion attempt failed due to unspecified circumstances.

delete_restricted

A deletion attempt failed because this record restricts deletion.

discover_disabled

An attempt to use an Discover card failed due to it being disabled.

do_not_honor

Do Not Honor

duplicate_file

An attempt to upload a file failed because a file already exists for that record.

duplicate_record

A record save failed because it is a duplicate record on a resource that does not allow duplicates.

duplicate_referenced_record

A record save failed because it references a record that is referenced elsewhere.

duplicate_transaction

Duplicate transaction

echeck_disabled

An attempt to use a bank account as a method of payment failed due to its being disabled.

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 more than one field of a set of exclusive fields were set.

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

An attempt to save a record failed because expiration was set when using a bank account.

expired_card

Expired Card

field_restricted

An attempt to save a record failed because a restricted field was set.

funding_currency_error

A transaction creation attempt failed because the fundingCurrency provided is not supported for this merchant.

funding_disabled

An attempt to save a record failed because funding is disabled and the record requires funding to be enabled.

general

An unspecified error or decline occurred.

generic_decline

Customer Cancel

generic_error

An unspecified error or decline occurred.

incorrect_cvv

CVV2 Value Mismatch

incorrect_pin

Incorrect PIN

insufficient_funds

Insufficient Funds

internal_error

An internal error occurred. Please try again.

invalid_account

Invalid Account Number

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

An attempt to save a record failed because the image specification supplied was invalid.

invalid_bin

An attempt to save a method of payment failed because the bin was invalid.

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 number was invalid.

invalid_characters

An attempt to save a record failed because it contained invalid characters.

invalid_currency

An attempt to save a record failed because it contained an invalid currency identifier.

invalid_cvv

Decline CVV2/CID Fail

invalid_date

An attempt to save a record failed because it contained an invalid date.

invalid_email

An attempt to save a record failed because it contained an invalid email.

invalid_enum_value

An attempt to save a record failed because it contained an invalid enumeration value.

invalid_fund

An attempt to reserve funds failed because the fund specified was invalid.

invalid_hostname

An attempt to save a record failed because it contained an invalid host name.

invalid_ip

An attempt to save a record failed because it contained an invalid IP address.

invalid_json

An attempt to save a record failed because it contained an invalid JSON string.

invalid_ksn

An attempt to save a method of payment failed because the KSN (key serial number) supplied was invalid.

invalid_length

An attempt to save a record failed because the character length was invalid.

invalid_maximum_value

An attempt to save a record failed because it contained a numeric value that exceeded the maximum.

invalid_minimum_value

An attempt to save a record failed because it contained a numeric value below the minimum.

invalid_non_scalar

An attempt to save a record failed because it contained an invalid, non-scalar value.

invalid_not_present

Security code does not match

invalid_pin

Invalid Pin

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.

invalid_relative_value

An attempt to save a record failed because it contained values that were relatively invalid.

invalid_request

Request structure was invalid.

invalid_resource

The resource specified was invalid.

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

Invalid status transition.

invalid_url

The requested URL was invalid.

invalid_value

An attempt to save a record failed because the supplied value was invalid.

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.

issuer_not_available

Issuer Unavailable

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

Security code does not match

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.

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.

no_such_file

The requested file does not exist.

no_such_record

The specified record does not exist.

no_such_user

The specified user does not exist.

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

Cardholder transaction not permitted

not_processed

Security code checking is unavailable

not_supported

Security code checking is unavailable

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

Pick Up Card

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.

required_field_list

An attempt to save a record failed because one of a set of fields is required and all were left unset.

reserve_error

An attempt to reserve funds failed.

restricted_card

Restricted Card

revocation_of_authorization

Cardholder requested that recurring or installment payment be stopped

same_day_payouts_disabled

An attempt to save a sameDay payout failed because same day payouts are disabled.

security_violation

Security Violation / Invalid AMEX CID

service_not_allowed

Invalid Merchant

stolen_card

Pick Up Card - Stolen

ticket_limit_exceeded

Daily Card Ticket Limit Exceeded

too_many_decision_levels

An attempt to save a linked decision failed because it would create too many levels in the decision hierarchy.

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

Daily Card Limit Exceeded

txn_limit_exceeded

A transaction creation attempt failed because it exceeds the merchant's transaction total limit.

txn_minimum_threshold

A transaction creation attempt failed because the total was less than the merchant's transaction total threshold.

txn_type_payment_method_mismatch

A transaction creation attempt failed because the method of payment is not allowed for the transaction type requested.

unauthorized

Transaction not allowed at terminal

unavailable

Processing Network Unavailable

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

Exceeds Withdrawal Limit

zip_match_address_mismatch

Partial match: zip matches, street address does not match

zip_match_address_not_verified

Partial match: zip matches, street address not verified