processorInformation. merchantAdvice.code
Category code indicating information about a decline.
When this field is used for Mastercard with
FDC Nashville Global
, it is available
only for card-not-present declined transactions. When this field is used for Visa with
FDC Nashville Global
, it is available for both card-present and card-not-present
declined transactions.IMPORTANT
Use the values returned in this field for Visa and Mastercard to
determine whether to retry declined transactions. Update your retry logic to ensure that a
retry is not attempted when the card association won't approve the transactions. A retry on
a transaction with a value in this field that prohibits retry, such as the value of
1
for Visa (Issuer never approves) or 3
for Mastercard
(Do not try again), can incur a penalty from card companies.IMPORTANT
If a decline does not have a merchant advice code in the response, the
default is not to retry the transaction.
Visa and Mastercard, in addition to the merchant advice codes, provide decline response
codes. American Express and Discover do not provide category codes, but they do provide
decline response codes.
Possible Values for Chase Paymentech Solutions, FDC Nashville Global, GPX, and Visa Platform Connect
Processors
Chase Paymentech Solutions
, FDC Nashville Global
, GPX
, and Visa Platform Connect
ProcessorsVisa:
- 1: Issuer never approves
- 2: Issuer cannot approve at this time
- 3: Data quality/revalidate payment information
Mastercard:
- 01: New account information available
- 02: Try again later
- 03: Do not try again
- 04: Token not supported
- 21: Do not honor
- 22: Merchant does not qualify for product code
- 24: Retry after 1 hour
- 25: Retry after 24 hours
- 26: Retry after 2 days
- 27: Retry after 4 days
- 28: Retry after 6 days
- 29: Retry after 8 days
- 30: Retry after 10 days
- 40: Non-reloadable prepaid card
- 41: Non-reloadable prepaid card
- 42: Sanctions score exceeds applicable threshold value
- 99: Do not try again
Specifications
- Data Type:String
- Data Length:2
Mapping Information
- REST API Field:processorInformation.merchantAdvice.code
- SCMP API Field:merchant_advice_code
- Simple Order API Field:ccAuthReply_merchantAdviceCode