Card decline errors

DocsCurrentAdvancedLast updated: May 24th 2023, @ 6:14:20 pm


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.

AVS error response codes

  1. Visa, Mastercard, Discover, American Express
  2. Maestro
AVS codeMeaningMatched details
AAddressAddress only (no ZIP code)
BInternational "A"Address only (no ZIP code)
CInternational "N"None. The transaction is declined.
DInternational "X"Address and Postal Code
ENot allowed for MOTO (Internet/Phone) transactionsNot applicable. The transaction is declined.
FUK-specific "X"Address and Postal Code
GGlobal UnavailableNot applicable
IInternational UnavailableNot applicable
MAddressAddress and Postal Code
NNoNone. The transaction is declined.
PPostal (International "Z")Postal Code only (no Address)
RRetryNot applicable
SService not SupportedNot applicable
UUnavailableNot applicable
WWhole ZIPNine-digit ZIP code (no Address)
XExact matchAddress and nine-digit ZIP code
YYesAddress and five-digit ZIP
ZZIPFive-digit ZIP code (no Address)
All othersErrorNot applicable

CVV error response codes

  1. Visa, Mastercard, Discover, American Express
  2. Maestro
CVV2 codeMeaningMatched details
EError - Unrecognized or Unknown responseNot applicable
IInvalid or NullNot applicable
MMatchCVV2 / CSC
NNo matchNone
PNot processedNot applicable
SService not supportedNot applicable
UUnknown - Issuer is not certifiedNot applicable
XNo responseNot applicable
All othersErrorNot applicable

See also