Native Card Issuance Error Codes & Transaction Status Notes

For a full list of Transaction Statuses, refer to this page.

Native Card Issuance Errors

CodeDescription
GENERAL_ERRORWrong card details such as PAN, PIN, CVV, or similar.
CLOSED_PANCard account is closed
EXPIRED_PANCard account has expired (the expiration date has passed).
INACTIVE_PANCard account is inactive (has not been activated yet).
INCORRECT_EXPIRATION_DATEExpiration date is incorrect; also used if the card has expired.
INCORRECT_PANIncorrect card number
INCORRECT_PINSelf-explanatory
LOCKED_PINThe maximum number of PIN attempts has been exceeded.
STOLEN_PANCard account has been reported as lost/stolen.
CONTACT_CARD_ISSUERThe accountholder should contact the issuer before retrying this transaction.
INSUFFICIENT_FUNDSSelf-explanatory
INVALID_AMOUNTSelf-explanatory
TRANSACTION_BLOCKEDThe issuer has blocked this transaction, either due to processing rules or fraud rules.
WITHDRAWAL_AMOUNT_EXCEEDEDThe issuer's limit on the cumulative amount of dollars withdrawn has been exceeded.
WITHDRAWAL_COUNT_EXCEEDEDThe issuer's limit on the number of withdrawals has been exceeded.
FOREIGN_TRANSACTIONS_NOT_ENABLEDForeign transactions are not enabled on card account

Transaction Status Notes

For Native Card Issuance, transactions that come back with either SETTLED or RETURNED transaction status will also come back with a transaction status note. The note will both be provided in the transaction's recent_status object, and in the last object within the transaction's timeline[] array.

Note: Some CANCELED transactions will also come back with a transaction status note (e.g. transactions submitted with invalid CVV or transactions blocked due to association with gambling, suspected fraud, etc.).

note‌‌Associated STATUS_IDAssociated STATUSComment
partial_reversal4SETTLEDPassed back when reversing a partial amount of the original charge.
pre_auth_completion4SETTLEDPassed back when transaction settles (i.e. hold has been lifted and relevant funds have been transferred).
force_post4SETTLEDPassed back when transaction settled as a force-post transaction (e.g. an offline transaction in which a merchant manually entered an authorization code). Please note that force-posted transactions bypass the issuer authorization process and may entail higher level of chargeback risk.
adjustment4SETTLEDPassed back when transaction settled as an offline adjustment to another already-settled transaction.
full_reversal6RETURNEDPassed back when reversing the full amount of the original charge, but merchant reversed the transaction without providing additional details.
full_reversal|
customer_cancellation
6RETURNEDThe user cancelled the transaction or the merchant cancelled the transaction on the user's behalf.
full_reversal|
merchant_cancellation
6RETURNEDThe merchant decided not to complete the transaction even though it was approved. (e.g. the transaction was approved, but the Address Verification Service (AVS) didn't match, so the merchant cancelled and the transaction reversed).
full_reversal|
merchant_cancellation_avs_mismatch
6RETURNEDThe merchant decided not to complete the transaction because the provided billing address does not matches the address on file for the user.
full_reversal|
misdispense
6RETURNEDThe merchant is reversing the transaction because the user was charged or received an incorrect amount. For example, a user may try to withdraw $100 at the ATM but the ATM only has $80. A merchant may also use this reversal reason if they charged the user the wrong amount. In some cases a new transaction is created with the correct amount.
full_reversal|
terminal_error
6RETURNEDThe merchant's terminal malfunctioned or experienced a communication error. The terminal was unable to complete the transaction, so the merchant's processor reversed the transaction.
pre_auth_expiration6RETURNEDPassed back when transaction is returned as a result of an authorization hold expiring without being finalized.
timeout6RETURNEDAn authorization decision was not returned in the time normally allotted for native card transactions, and the transaction was returned on credit.
transaction_blocked|
online_pharmacy_purchase
5CANCELEDThis transaction was blocked because online pharmacy purchases are disallowed.
transaction_blocked|
online_tobacco_purchase
5CANCELEDThis transaction was blocked because online tobacco purchases are disallowed.
transaction_blocked|
online_gambling
5CANCELEDThis transaction was blocked because online gambling transactions are disallowed.
transaction_blocked|
animal_related_gambling
5CANCELEDThis transaction was blocked because horse and dog racing gambling transactions are disallowed.
transaction_blocked|
gambling_transaction
5CANCELEDThis transaction was blocked because gambling transactions are disallowed.
transaction_blocked|
emv_fallback
5CANCELEDThis transaction was blocked because magnetic stripe fallback transactions have a high risk of fraud.
transaction_blocked|
invalid_amount
5CANCELEDThis transaction was blocked because the amount data appears invalid.
transaction_blocked|
restricted_card
5CANCELEDThis transaction was blocked because it violates restrictions placed on this card.
transaction_blocked|
suspected_fraud
5CANCELEDThis transaction was blocked because there is a high likelihood it is fraudulent.
transaction_blocked|
network_error
5CANCELEDThis transaction was blocked due to a network error.
bad_icvv5CANCELEDThe CVV passed with this transaction is invalid.

[card authorization issue]
bad_cvv15CANCELEDThe CVV passed with this transaction is invalid.

[card authorization issue]
bad_cvv25CANCELEDThe CVV passed with this transaction is invalid.

[card authorization issue]
bad_arqc5CANCELEDThe EMV cryptogram passed with this transaction is invalid.

[card authorization issue]