1 Rules for Decline Response Codes
Visa and Mastercard implemented rules in October and November 2021 which required issuers (BIN sponsors) and acquirers to properly use and manage declined transaction response codes, eliminate excessive reattempts and ensure data consistency in authorisation transactions. The schemes enforce penalty fees to increase compliance with these rules. These rules apply to issuers in Europe, AP, Canada and CEMEA.
To support the scheme rules, Thredd provides suitable card status codes and response fields to use in your EHI response messages where you decline an authorisation request.
Your systems should return appropriate response codes when you decline transaction authorisation requests (relevant if you are using EHI modes 1, 2 and 4).
1.1 Mastercard Rules
-
AN 4536 - Effective 2nd November 20211: No more than 5% of card-not-present declines should use the ‘05’ (do not honour) response code2. In your EHI response, you should return an appropriate response code to reflect the reason for the decline and reduce the use of the generic 05 code. For details, see Decline Response Code Categories.
-
AN 4536 / AN 4811 - Effective 1st October 2021: Thredd returns a Merchant Advice Code (MAC) field in our authorisation response to Mastercard, which provides more information to the merchant on the reason for a decline. In your EHI response, you can return an optional MerchantAdvice field to set the value of this response field. If not used, Thredd will return a default response. For details, see EHI Field MerchantAdvice.
1.2 Visa Rules
-
Article 5.1 - Effective 1st October 20213: Avoid using generic decline codes (such as 05 – do not honour), for both card-present and card-not-present declines. For a list of suitable codes to use, see Decline Response Codes
-
You must use a suitable response code for refund request approvals and declines. See Response Codes for Refund Requests.
-
Response codes 12 and 15 are Visa-only codes effective from 12 April 2025. If an Issuer uses these codes incorrectly, then Visa will convert the response and send it to the Acquirer as a generic response code decline. See EHI Response Codes.
-
Effective 18 October 2025 Visa have stated that Response Code 57 (Transaction not permitted to cardholder) cannot be used for individual PANs to generically decline a transaction. Please note:
-
Response code 57 can still be used if the decline condition applies to all PANs for the same product.
-
If code 57 is used for individual PANs after 18th October, Visa will convert it to a generic response code decline. You should be aware that excessive use of generic response codes above Visa’s thresholds will result in system integrity fees.
-
Note that any decline fees set up for response code 57 (using the Thredd Fees service) will no longer apply.
-
Thredd recommends that these rules are respected in authorisation responses.
1.3 Thredd Status Codes
Thredd provides a number of card status codes which you can use to set the status of your cards to support decline response reporting. See Card Status Codes.