Simulate card verification outcomes
Last updated: July 19, 2023
When you carry out a card verification value (CVV) check, or perform a card verification, you'll be notified of the outcome through a CVV code.
You can simulate the various possible outcomes of a CVV check to test your integration is working as expected.
To test the various outcomes, set up a new payment request and:
- Set the
source.number
field to4659105569051157
to test a Visa CVV check, or5305484748800098
to test a Mastercard CVV check. Alternatively, you can use any other of our Visa or Mastercard test cards. - Regardless of the card number used, set the
source.cvv
field to one of the values from the following table, depending on the outcome you want to test for.
CVV check outcome | Description | source.cvv value |
---|---|---|
| CVV did not match |
|
| CVV should be on the card, but the merchant indicated that it is not present | Leave field empty |
| CVV check was not performed |
|
| The issuer does not support CVV |
|
| CVV matched | Any three-digit number not listed in the table |
1{2"source": {3"type": "card",4"number": "4659105569051157",5"cvv": "100",6"expiry_month": 12,7"expiry_year": 20308},9"currency": "USD",10"processing_channel_id": "pc_dkgoofpvuwuerekvd4ssr6jwom"11}
Regardless of the CVV used, the response will contain a response_code
field with the value 10000
.
1{2"id": "pay_aqwuar5sjb5upkupgywyzapfii",3"action_id": "act_aqwuar5sjb5upkupgywyzapfii",4"currency": "USD",5"approved": true,6"status": "Card Verified",7"response_code": "10000",8"source": {9"type": "card",10"expiry_month": 12,11"expiry_year": 2030,12"scheme": "Visa",13"last4": "1157",14"fingerprint": "F31828E2BDABAE63EB694903825CDD36041CC6ED461440B81415895855502832",15"bin": "424242",16"cvv_check": "Y"17},18"processed_on": "2023-01-17T17:41:52Z",19"_links": {20"self": {21"href": "https://api.sandbox.checkout.com/payments/pay_aqwuar5sjb5upkupgywyzapfii"22},23"actions": {24"href": "https://api.sandbox.checkout.com/payments/pay_aqwuar5sjb5upkupgywyzapfii/actions"25}26}27}