Result codes
Address Verification Service (AVS)
Address Verification Service (AVS) is a service provided by the payment brands that determines the match or partial match of the consumer's address information. Below is a table of AVS response codes and their descriptions.
Code | Description | Visa | Mastercard |
---|---|---|---|
A | Address matches, zip code does not match. | ✅ | ✅ |
B | Address matches, postal code does not match (foreign card). | ✅ | - |
C | Address and postal code do not match (foreign card). | ✅ | - |
D | Address and postal code match (foreign card). | ✅ | - |
E | Ineligible transaction or message contains content error. | ✅ | - |
F | Address and postal code match (UK only). | ✅ | - |
G | Address and postal code verification not supported by card issuer (foreign card). | ✅ | - |
I | Address not verified (foreign card). | ✅ | - |
M | Address and postal code match (foreign card). | ✅ | - |
N | Neither address nor ZIP code matches. | ✅ | ✅ |
P | Postal code matches, address does not match (foreign card). | ✅ | - |
R | System unavailable or timed out. Retry. | ✅ | ✅ |
S | Card issuer does not support address verification system. | ✅ | ✅ |
U | Address information is unavailable (domestic). | ✅ | ✅ |
W | 9-digit ZIP code matches, address does not match. | ✅ | ✅ |
X | Address and 9-digit ZIP code match. | ✅ | ✅ |
Y | Address and 5-digit ZIP code match. | ✅ | ✅ |
Z | 5-digit ZIP code matches, address does not. | ✅ | ✅ |
Card Verification Value (CVV)
The table below explains the card verification value (CVV) response codes that you might receive when you are carrying out a CVV check or verifying a card.
Code | Description |
---|---|
M | Card verification value matches. |
N | Card verification value does not match or is invalid. |
P | Card verification value not processed. |
U | Issuer not registered. Issuer has not certified for CVV or issuer has not provided Visa with the CVV encryption keys. |
S | Issuer indicates that CVV data should be present on the card, but the merchant has indicated data is not present on the card. |
Merchant Advice Code (MAC)
The Merchant Advice Code (MAC) is a Mastercard-specific code that provides more details about a response:
- The reason for approving or declining a transaction.
- The actions merchants can take to continue to serve their customers.
Code | Description |
---|---|
01 | New account information available. |
02 | Cannot approve at this time, try again later. |
03 | Do not try again. |
04 | Token requirements not fulfilled for this token type. |
05 | Negotiated value not approved. |
21 | Recurring payment cancelled. |
22 | Merchant does not qualify for product code. |
24 | Retry after 1 hour (Mastercard use only). |
25 | Retry after 24 hours (Mastercard use only). |
26 | Retry after 2 days (Mastercard use only). |
27 | Retry after 4 days (Mastercard use only). |
28 | Retry after 6 days (Mastercard use only). |
29 | Retry after 8 days (Mastercard use only). |
30 | Retry after 10 days (Mastercard use only). |
40 | Consumer non-reloadable prepaid card. |
41 | Consumer single-use virtual card number. |
42 | Sanctions scoring service. |
43 | Consumer multi-use virtual card number. |