Native Card Issuance Error Codes & Transaction Status Notes
For a full list of Transaction Statuses, refer to this page.
Native Card Issuance Errors
Code | Description |
---|---|
GENERAL_ERROR | Wrong card details such as PAN, PIN, CVV, or similar. |
CLOSED_PAN | Card account is closed |
EXPIRED_PAN | Card account has expired (the expiration date has passed). |
INACTIVE_PAN | Card account is inactive (has not been activated yet). |
INCORRECT_EXPIRATION_DATE | Expiration date is incorrect; also used if the card has expired. |
INCORRECT_PAN | Incorrect card number |
INCORRECT_PIN | Self-explanatory |
LOCKED_PIN | The maximum number of PIN attempts has been exceeded. |
STOLEN_PAN | Card account has been reported as lost/stolen. |
CONTACT_CARD_ISSUER | The accountholder should contact the issuer before retrying this transaction. |
INSUFFICIENT_FUNDS | Self-explanatory |
INVALID_AMOUNT | Self-explanatory |
TRANSACTION_BLOCKED | The issuer has blocked this transaction, either due to processing rules or fraud rules. |
WITHDRAWAL_AMOUNT_EXCEEDED | The issuer's limit on the cumulative amount of dollars withdrawn has been exceeded. |
WITHDRAWAL_COUNT_EXCEEDED | The issuer's limit on the number of withdrawals has been exceeded. |
FOREIGN_TRANSACTIONS_NOT_ENABLED | Foreign 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_ID | Associated STATUS | Comment |
---|---|---|---|
partial_reversal | 4 | SETTLED | Passed back when reversing a partial amount of the original charge. |
pre_auth_completion | 4 | SETTLED | Passed back when transaction settles (i.e. hold has been lifted and relevant funds have been transferred). |
force_post | 4 | SETTLED | Passed 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. |
adjustment | 4 | SETTLED | Passed back when transaction settled as an offline adjustment to another already-settled transaction. |
full_reversal | 6 | RETURNED | Passed back when reversing the full amount of the original charge, but merchant reversed the transaction without providing additional details. |
full_reversal| customer_cancellation | 6 | RETURNED | The user cancelled the transaction or the merchant cancelled the transaction on the user's behalf. |
full_reversal| merchant_cancellation | 6 | RETURNED | The 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 | 6 | RETURNED | The 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 | 6 | RETURNED | The 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 | 6 | RETURNED | The 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_expiration | 6 | RETURNED | Passed back when transaction is returned as a result of an authorization hold expiring without being finalized. |
timeout | 6 | RETURNED | An 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 | 5 | CANCELED | This transaction was blocked because online pharmacy purchases are disallowed. |
transaction_blocked| online_tobacco_purchase | 5 | CANCELED | This transaction was blocked because online tobacco purchases are disallowed. |
transaction_blocked| online_gambling | 5 | CANCELED | This transaction was blocked because online gambling transactions are disallowed. |
transaction_blocked| animal_related_gambling | 5 | CANCELED | This transaction was blocked because horse and dog racing gambling transactions are disallowed. |
transaction_blocked| gambling_transaction | 5 | CANCELED | This transaction was blocked because gambling transactions are disallowed. |
transaction_blocked| emv_fallback | 5 | CANCELED | This transaction was blocked because magnetic stripe fallback transactions have a high risk of fraud. |
transaction_blocked| invalid_amount | 5 | CANCELED | This transaction was blocked because the amount data appears invalid. |
transaction_blocked| restricted_card | 5 | CANCELED | This transaction was blocked because it violates restrictions placed on this card. |
transaction_blocked| suspected_fraud | 5 | CANCELED | This transaction was blocked because there is a high likelihood it is fraudulent. |
transaction_blocked| network_error | 5 | CANCELED | This transaction was blocked due to a network error. |
bad_icvv | 5 | CANCELED | The CVV passed with this transaction is invalid. [card authorization issue] |
bad_cvv1 | 5 | CANCELED | The CVV passed with this transaction is invalid. [card authorization issue] |
bad_cvv2 | 5 | CANCELED | The CVV passed with this transaction is invalid. [card authorization issue] |
bad_arqc | 5 | CANCELED | The EMV cryptogram passed with this transaction is invalid. [card authorization issue] |
Updated about 4 years ago