CVV Testing

Overview

The Card Verification Code Check (CVV) is a security parameter that checks the CVV value in the request against the issuing bank's records, to ensure that the values match. If the value does not match the transaction may be declined (depending on the issuer).

The CVV (or sometimes referred to as CVV2) is the three or four digit number printed on the back of Visa or Mastercard branded cards (typically in the signature box). For Amex cards, the CVV value is found on the front of the card.

You must input the CVV value into your request, if left empty you will receive a validation error-type.

❗️

Warning

If you choose to accept transactions that have failed the CVV check, you are increasing the likelihood of a dispute being raised.

The CVV check response will be returned in the check object in the cvv field. The response will either be matched, not_matched or not_checked.


Request and response values

The below table details what values to include in your request to test the different responses:

RequestResponse
"cvv:"123""cvv":"matched"
"cvv:"456""cvv":"not_matched"
"cvv:"789""cvv":"not_checked"