Card decline errors

DOCSCurrentADVANCED

Last updated: Feb 6th, 9:12am

To understand why a card payment was declined, the Orders v2 API processor_response object includes values returned for card transactions.

The following tables list possible AVS and CVV error response decline values and descriptions.

Error response codes

Visa, Mastercard, Discover, and American Express use the same alphabetical AVS and CVV error codes. Maestro uses numeric AVS and CVV error codes.

Choose a payment process method from the dropdown menu below:

AVS Error

AVS Code Meaning Matched details
A Address Address only (no ZIP code)
B International "A" Address only (no ZIP code)
C International "N" None. The transaction is declined.
D International "X" Address and Postal Code
E Not allowed for MOTO (Internet/Phone) transactions Not applicable. The transaction is declined.
F UK-specific "X" Address and Postal Code
G Global Unavailable Not applicable
I International Unavailable Not applicable
M Address Address and Postal Code
N No None. The transaction is declined.
P Postal (International "Z") Postal Code only (no Address)
R Retry Not applicable
S Service not Supported Not applicable
U Unavailable Not applicable
W Whole ZIP Nine-digit ZIP code (no Address)
X Exact match Address and nine-digit ZIP code
Y Yes Address and five-digit ZIP
Z ZIP Five-digit ZIP code (no Address)
All others Error Not applicable


CVV Error

CVV2 CodeMeaningMatched details
EError - Unrecognized or Unknown responseNot applicable
IInvalid or NullNot applicable
MMatchor CSC
NNo matchNone
PNot processedNot applicable
SService not supportedNot applicable
UUnknown - Issuer is not certifiedNot applicable
XNo responseNot applicable
All othersErrorNot applicable

See Also

Optional

Orders errors

Details about errors for the Orders v2 API.

If you accept cookies, we’ll use them to improve and customize your experience and enable our partners to show you personalized PayPal ads when you visit other sites. Manage cookies and learn more