Issuer decline codes & Merchant advise codes (MAC)

This article provides the list of issuer decline codes you can receive in the Gateway's API response.

Both VISA and MasterCard have introduced a set of decline codes to provide additional information about a transaction. These decline codes can help understand the reason for a particular transaction outcome or provide instructions on how to proceed.

The meaning of codes varies depending on VISA/MasterCard. Additionally, a single code may be associated with multiple categories within a given payment system.

📘

Note

Therefore, we strongly recommend thoroughly analyzing the decline codes received in the IPN, taking into account the specific payment system to which they belong, and especially the category they are associated with.

Response categories

Based on Visa.

Response Category

Description

Issuer Requirements

Acquirer/Merchant Requirements

Codes

1

Issuer will never approve

An account or transaction type is permanently blocked and will never be approved by the issuer.

An account or transaction type is permanently blocked and will never be approved by the issuer.

5003,5004,5007,
5008,5012, 5015, 5041,5043, 5057, 5062,5078, 5093,
5250

2

Issuer cannot approve at this time

Issuers must provide Category 2 response codes for any temporary decline condition.

Acquirers / merchants may resubmit a declined transaction for authorization a maximum of 15 times in 30 days.

5019, 5031, 5032, 5051, 5059, 5061, 5065, 5075,5086, 5091, 5096

3

Data quality (re-validate data)

Invalid payment or authentication data has been provided and approval may be obtained at a future date if resubmitted with corrected information.

Issuers must provide Category 3 response codes to indicate the decline condition is due to invalid data, and may choose to approve a resubmission with corrected information.

Acquirers / merchants may resubmit a declined transaction for authorization a maximum of 15 times in 30 days.

5014, 5034, 5054, 5055,5082

4

Generic response codes

All other decline responses not contained in Categories 1 through 3.

Issuers may use response codes in Category 4 only when no other decline response code can logically be applied.

Acquirers / merchants are permitted to resubmit a declined transaction for authorization a maximum of 15 times in 30 days.

5000, 5001,5005,
5006, 5010, 5013,
5016, 5030, 5046,
5058, 5063, 5070,
5080, 5085, 5094,
5099, 5220, 5221,
5222, 5223, 5224,
5225

Decline codes

CodeDescription
1001Underpayment. Paid amount is less than the requested amount
1002Overpayment. Paid amount is greater than the requested amount
5000General bank decline
5001Refer to Issuer
5003Invalid merchant
5004Pick up card (no fraud)
5005Do not honor
5006Payment could not be authorized
5007Pick up card, special condition (fraud account)
5008Reattempt not permitted
5010Partial approval
5012Invalid transaction
5013Invalid amount
5014Invalid card number
5015No such issuer
5016Invalid cardholder name
5019Re-enter transaction
5030Format error
5041Lost card, pick up (fraud account)
5043Stolen card, pick up (fraud account)
5046Closed account
5051Insufficient funds
5053Wrong expiration date
5054Expired card
5055Invalid PIN
5057Transaction not permitted - Card
5058Transaction not permitted - Terminal
5059Suspected fraud
5061Withdrawal amount limit exceeded
5062Invalid service code, restricted
5063Security violation
5065Activity limit exceeded
5070PIN data required
5075PIN tries exceeded
5078Invalid/nonexistent account specified (general)
5079Blocked, first used
5080Credit issuer unavailable
5082Negative online CAM, dCVV, iCVV, CVV, or CAVV results or offline PIN authentication interrupted
5085No reason to decline
5086Cannot verify PIN
5091Issuer or switch is unavailable
5093Violation, cannot complete
5094Duplicate transaction
5095Violation, blocked country
5096System error
5099Expired payment
5220Authentication failed by card issuer
5221Authentication is unavailable at the moment
5222Payment attempt failed or canceled
5223Rejected authentication by the issuer
5224Card not enrolled
5225Attempts processing performed
5226Card account number not found in the card ranges from the Directory Server
52273D Secure SCA required
5228Verification not completed, timeout
5031Invalid Cardholder address
5032Invalid phone number
5034Invalid currency
5250Unsupported zero price transaction
5300BIC is not SDD compliant

Test credentials decline codes

CodeDescriptionSuggested action
6301IP does not match payment detailsWhitelist your IP address
6302Test IP found but payment details are incorrectYou are trying to perform a test transaction using a real card number. Change card number