{"title":"Testing card CVC\/CVV\/CID result codes","category":"default","creationDate":1779620072,"content":"<p>You can test this if your integration uses the following:<\/p>\n<ul>\n<li>Advanced flow<\/li>\n<li>Sessions flow with additional methods<\/li>\n<\/ul>\n<p>Issuers may check the <a href=\"\/get-started-with-adyen\/adyen-glossary\/#card-security-code-cvc-cvv-cid\">card security code<\/a> (CVC\/CVV\/CID) for online transactions. Based on the check, the transaction can be approved or declined. The result of the check may also be used in <a href=\"\/risk-management\/configure-your-risk-profile\/post-auth-rules\">post-authorization risk rules<\/a>.<\/p>\n<h2>Requirements<\/h2>\n<p>Enable <code>additionalData.cvcResult<\/code> field in your API response:<\/p>\n<ol>\n<li>In your <a href=\"https:\/\/ca-test.adyen.com\/\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">test Customer Area<\/a>, go to <strong>Developers<\/strong> &gt; <strong>Additional data<\/strong>.<\/li>\n<li>Under <strong>Acquirer<\/strong>, select the checkbox for <strong>Acquirer result<\/strong>.<\/li>\n<\/ol>\n<h2>Step 1: Make a test payment request<\/h2>\n<p>For testing, you must use unencrypted <a href=\"\/development-resources\/test-cards-and-credentials\/test-card-numbers\/\">test card details<\/a>. In your live environment, if you only use encrypted card details, the API response includes the same information.<\/p>\n<p>Make a test  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Checkout\/latest\/post\/payments\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">\/payments<\/a> request and set <code>paymentMethod.cvc<\/code> to one of the <a href=\"#result-code-values\">result codes values<\/a>. Add <strong>00<\/strong> to the beginning of the value. For example, to make a test payment request that gets the result code <strong>4<\/strong>, specify <code>paymentMethod.cvc<\/code>: <strong>004<\/strong>:<\/p>\n<div data-component-wrapper=\"code-sample\">\n    <code-sample :title=\"'Test payment request to get the CVC\/CVV\/CID result code 4'\" :id=\"''\" :code-data='[{\"language\":\"json\",\"tabTitle\":\"\",\"content\":\"{\\n   \\\"amount\\\": {\\n      \\\"currency\\\": \\\"EUR\\\",\\n      \\\"value\\\": 2000\\n   },\\n   \\\"paymentMethod\\\":{\\n      \\\"type\\\": \\\"scheme\\\",\\n      \\\"number\\\": \\\"4111111111111111\\\",\\n      \\\"cvc\\\": \\\"004\\\",\\n      \\\"expiryMonth\\\": \\\"03\\\",\\n      \\\"expiryYear\\\": \\\"2030\\\",\\n      \\\"holderName\\\": \\\"Adyen Test\\\"\\n   },\\n      \\\"reference\\\":\\\"YOUR_ORDER_NUMBER\\\",\\n      \\\"merchantAccount\\\":\\\"YOUR_MERCHANT_ACCOUNT\\\",\\n      \\\"returnUrl\\\": \\\"https:\\\/\\\/your-company.example.com\\\/\\\"\\n   }\\n}\"}]' :enable-copy-link-to-code-block=\"true\" :code-sample-card-size=\"'fullsize'\"><\/code-sample>\n<\/div>\n<h2>Step 2: Get the result code in the response<\/h2>\n<p>The API response includes the <code>cvcResult<\/code> that you specified in the request:<\/p>\n<div data-component-wrapper=\"code-sample\">\n    <code-sample :title=\"'Response that includes the CVC\/CVV\/CID result code 4'\" :id=\"''\" :code-data='[{\"language\":\"json\",\"tabTitle\":\"\",\"content\":\"{\\n   \\\"additionalData\\\":{\\n      \\\"cvcResult\\\":\\\"4 No CVC\\\/CVV provided, but was required\\\",\\n      \\\"cvcResultRaw\\\":\\\"S\\\",\\n      \\\"refusalReasonRaw\\\":\\\"DECLINED CVC Incorrect\\\"\\n   },\\n   \\\"pspReference\\\":\\\"9914613171800003\\\",\\n   \\\"refusalReason\\\":\\\"Refused\\\",\\n   \\\"resultCode\\\":\\\"Refused\\\"\\n   }\\n}\"}]' :enable-copy-link-to-code-block=\"true\" :code-sample-card-size=\"'fullsize'\"><\/code-sample>\n<\/div>\n<h2>Result code values<\/h2>\n<table>\n<thead>\n<tr>\n<th><\/th>\n<th>CVC\/CVV result code<\/th>\n<th>Result<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>0<\/td>\n<td>Unknown<\/td>\n<td>Approval<\/td>\n<\/tr>\n<tr>\n<td>1<\/td>\n<td>Matches<\/td>\n<td>Approval<\/td>\n<\/tr>\n<tr>\n<td>2<\/td>\n<td>Doesn't match<\/td>\n<td>Decline<\/td>\n<\/tr>\n<tr>\n<td>3<\/td>\n<td>Not checked<\/td>\n<td>Approval<\/td>\n<\/tr>\n<tr>\n<td>4<\/td>\n<td>No CVC\/CVV provided, but was required<\/td>\n<td>Decline<\/td>\n<\/tr>\n<tr>\n<td>5<\/td>\n<td>Issuer not certified for CVC\/CVV<\/td>\n<td>Approval<\/td>\n<\/tr>\n<tr>\n<td>6<\/td>\n<td>No CVC\/CVV provided<\/td>\n<td>Approval<\/td>\n<\/tr>\n<\/tbody>\n<\/table>","url":"https:\/\/docs.adyen.com\/development-resources\/testing\/result-codes\/cvc-cvv-cid-result-codes","articleFields":{"description":"Test getting card CVC\/CVV\/CID result codes with your integration and troubleshoot issues before it goes live.","cache_enable":false,"page_id":"796dcaa9-3f45-4394-9b41-08995d59efc1","feedback_component":true,"filters_component":false,"decision_tree":"[]"},"algolia":{"url":"https:\/\/docs.adyen.com\/development-resources\/testing\/result-codes\/cvc-cvv-cid-result-codes","title":"Testing card CVC\/CVV\/CID result codes","content":"You can test this if your integration uses the following:\n\nAdvanced flow\nSessions flow with additional methods\n\nIssuers may check the card security code (CVC\/CVV\/CID) for online transactions. Based on the check, the transaction can be approved or declined. The result of the check may also be used in post-authorization risk rules.\nRequirements\nEnable additionalData.cvcResult field in your API response:\n\nIn your test Customer Area, go to Developers &gt; Additional data.\nUnder Acquirer, select the checkbox for Acquirer result.\n\nStep 1: Make a test payment request\nFor testing, you must use unencrypted test card details. In your live environment, if you only use encrypted card details, the API response includes the same information.\nMake a test  \/payments request and set paymentMethod.cvc to one of the result codes values. Add 00 to the beginning of the value. For example, to make a test payment request that gets the result code 4, specify paymentMethod.cvc: 004:\n\n    \n\nStep 2: Get the result code in the response\nThe API response includes the cvcResult that you specified in the request:\n\n    \n\nResult code values\n\n\n\n\nCVC\/CVV result code\nResult\n\n\n\n\n0\nUnknown\nApproval\n\n\n1\nMatches\nApproval\n\n\n2\nDoesn't match\nDecline\n\n\n3\nNot checked\nApproval\n\n\n4\nNo CVC\/CVV provided, but was required\nDecline\n\n\n5\nIssuer not certified for CVC\/CVV\nApproval\n\n\n6\nNo CVC\/CVV provided\nApproval\n\n\n","type":"page","locale":"en","boost":16,"hierarchy":{"lvl0":"Home","lvl1":"Development resources","lvl2":"Testing your online payments integration","lvl3":"Testing result codes and refusal reasons","lvl4":"Testing card CVC\/CVV\/CID result codes"},"hierarchy_url":{"lvl0":"https:\/\/docs.adyen.com\/","lvl1":"https:\/\/docs.adyen.com\/development-resources","lvl2":"https:\/\/docs.adyen.com\/development-resources\/testing","lvl3":"https:\/\/docs.adyen.com\/development-resources\/testing\/result-codes","lvl4":"\/development-resources\/testing\/result-codes\/cvc-cvv-cid-result-codes"},"levels":5,"category":"Development Resources","category_color":"green","tags":["Testing","CVC\/CVV\/CID","result","codes"]}}