Simulate card verification outcomes

Last updated: April 24, 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 to 4659105569051157 to test a Visa CVV check, or 5305484748800098 to test a Mastercard CVV check.
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
`D`	CVV did not match	`204`
`N`	CVV should be on the card, but the merchant indicated that it is not present	Leave field empty
`P`	CVV check was not performed	`205`
`U`	The issuer does not support CVV	`202`
`Y`	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": 2030
8  },
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}

Simulate card verification outcomes

Request example

Response example