{"title":"Address Verification System (AVS)","category":"default","creationDate":1582713000,"content":"<p>The Address Verification System (AVS) is a service that verifies if a billing address matches the address of a credit card cardholder. AVS is a widely used fraud-prevention measure for <a href=\"\/pt\/get-started-with-adyen\/adyen-glossary\/#card-not-present-cnp\">Card Not Present<\/a> (CNP) transactions, such as online payments or point-of-sale <a href=\"\/pt\/point-of-sale\/mail-and-telephone-order-moto\">Mail Order\/Telephone Order (MOTO)<\/a> payments.<br \/>\nAVS gives you a way to check if the shopper who is placing the order is the same person as the cardholder, which is more likely if the billing address details match.<\/p>\n<h2>How does AVS work?<\/h2>\n<p>When a shopper pays for a transaction, you can collect their billing address details. Then, you send that data in the <code>billingAddress<\/code> object in the payment authorization request. When you have enabled AVS, the system checks if and to what extent these billing address details match the information that the issuing bank has on file about the holder of the credit card.<\/p>\n<p>The response to the payment request will contain an Adyen AVS response code that is mapped to a raw AVS response code. You can see the mapping in the <a href=\"#avs-mapping-table\">mapping table<\/a>.<\/p>\n<p>When the AVS check results in a mismatch, you can <a href=\"#avs-risk-rules\">trigger a risk rule<\/a>. When you use RevenueProtect, you can use the standard risk rule <a href=\"\/pt\/risk-management\/configure-manual-risk\/standard-risk-rules#consistency-rules\">Billing address does not match cardholder address<\/a>, or create a custom risk rule. When you use Protect, you can use the Adyen-provided <a href=\"\/pt\/risk-management\/configure-your-risk-profile\/post-auth-rules\">Address Verification System (AVS) rule<\/a>, or create a custom post-authorization rule.<\/p>\n<p>Based on the AVS response, you can decide what to do with the payment: you can accept, make an exception, or cancel a transaction.<\/p>\n<p>AVS is supported for card payments with Visa, Mastercard, Discover or American Express. Credit card issuers in the United States, Canada, the United Kingdom, and Europe (Visa only) must support AVS verification requests when you send them in, however, using AVS is not mandatory for you as a merchant.<\/p>\n<h2>Enable and test AVS<\/h2>\n<p>To be able to trigger AVS and the AVS risk rules, you set up your payment authorization requests to include billing address details. How you do that depends on your integration. Follow the instructions below that are relevant for you.<\/p>\n<h3 id=\"avs-for-ecommerce\">AVS in API requests<\/h3>\n<ol>\n<li>\n<p>Collect the shopper's billing address.<\/p>\n<ul>\n<li><strong>Checkout<\/strong>: Make sure that you collect the shopper's billing address details to include them in the payment request. If you are using a client-side integration for Web, the <a href=\"\/pt\/payment-methods\/cards\/web-drop-in\">Web Drop-in<\/a> and <a href=\"\/pt\/payment-methods\/cards\/web-component\">Card Component<\/a> can be configured to collect your shopper's billing address.<\/li>\n<li><strong>Classic integration<\/strong>: Make sure that you collect the shopper's billing address details to include them in the  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Payment\/latest\/post\/authorise\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">\/authorise<\/a> request.<\/li>\n<\/ul>\n<\/li>\n<li>\n<p>Send the collected billing address information in the payment authorization request. Provide the full address of the shopper using the <code>billingAddress<\/code> child element:<\/p>\n<ul>\n<li>When you submit the\u00a0<code>billingAddress<\/code>\u00a0object for AVS, the following child elements are required:<\/li>\n<\/ul>\n<table>\n<thead>\n<tr>\n<th>Field<\/th>\n<th>Type<\/th>\n<th style=\"text-align: center;\">Required<\/th>\n<th>Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td><code>country<\/code><\/td>\n<td>String<\/td>\n<td style=\"text-align: center;\"><span class=\"hint--bottom\" data-hint=\"Required\" markdown=\"1\"><img style=\"width: 25px;\" alt=\"Required\" src=\"\/user\/pages\/reuse\/image-library\/01.icons\/required\/required.svg?decoding=auto&amp;fetchpriority=auto\" \/><\/span><\/td>\n<td>The <code>country<\/code> value format needs to adhere to the <a href=\"https:\/\/en.wikipedia.org\/wiki\/ISO_3166-1_alpha-2\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">ISO 3166-1 alpha-2<\/a> standard.\u00a0An invalid country code results in a transaction\/request rejection.\u00a0You can <a href=\"https:\/\/www.iso.org\/obp\/ui\/\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">look up country codes<\/a> on the ISO website.<\/td>\n<\/tr>\n<tr>\n<td><code>city<\/code><\/td>\n<td>String<\/td>\n<td style=\"text-align: center;\"><span class=\"hint--bottom\" data-hint=\"Required\" markdown=\"1\"><img style=\"width: 25px;\" alt=\"Required\" src=\"\/user\/pages\/reuse\/image-library\/01.icons\/required\/required.svg?decoding=auto&amp;fetchpriority=auto\" \/><\/span><\/td>\n<td>The name of the city.<\/td>\n<\/tr>\n<tr>\n<td><code>street<\/code><\/td>\n<td>String<\/td>\n<td style=\"text-align: center;\"><span class=\"hint--bottom\" data-hint=\"Required\" markdown=\"1\"><img style=\"width: 25px;\" alt=\"Required\" src=\"\/user\/pages\/reuse\/image-library\/01.icons\/required\/required.svg?decoding=auto&amp;fetchpriority=auto\" \/><\/span><\/td>\n<td>The name of the street.<\/td>\n<\/tr>\n<tr>\n<td><code>houseNumberOrName<\/code><\/td>\n<td>String<\/td>\n<td style=\"text-align: center;\"><span class=\"hint--bottom\" data-hint=\"Required\" markdown=\"1\"><img style=\"width: 25px;\" alt=\"Required\" src=\"\/user\/pages\/reuse\/image-library\/01.icons\/required\/required.svg?decoding=auto&amp;fetchpriority=auto\" \/><\/span><\/td>\n<td>The number or name of the house.<\/td>\n<\/tr>\n<tr>\n<td><code>postalCode<\/code><\/td>\n<td>String<\/td>\n<td style=\"text-align: center;\"><span class=\"hint--bottom\" data-hint=\"Required\" markdown=\"1\"><img style=\"width: 25px;\" alt=\"Required\" src=\"\/user\/pages\/reuse\/image-library\/01.icons\/required\/required.svg?decoding=auto&amp;fetchpriority=auto\" \/><\/span><\/td>\n<td>A maximum of five digits for an address in the US, or a maximum of ten characters for an address in all other countries\/regions.<\/td>\n<\/tr>\n<tr>\n<td><code>stateOrProvince<\/code><\/td>\n<td>String<\/td>\n<td style=\"text-align: center;\"><span class=\"hint--bottom\" data-hint=\"Conditionally required\" markdown=\"1\"><img style=\"width: 25px;\" alt=\"Conditionally required\" src=\"\/user\/pages\/reuse\/image-library\/01.icons\/conditionally-required\/conditionally-required.svg?decoding=auto&amp;fetchpriority=auto\" \/><\/span><\/td>\n<td>Required for shoppers from the US or Canada. Provide the child element <code>stateOrProvince<\/code> as defined in ISO 3166-2. For example, <strong>CA<\/strong> in the US or <strong>ON<\/strong> for Canada. AVS does not validate <code>stateOrProvince<\/code>.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<ul>\n<li>Pass address lines, like apartment or unit number, as part of <code>street<\/code>.<\/li>\n<li>If you do not know the country\/region or are not collecting the country\/region from the shopper, provide <code>country<\/code> as <strong>ZZ<\/strong>.<\/li>\n<\/ul>\n<div class=\"notices blue\">\n<p>To qualify for better interchange rates submit the billing address and ZIP code for card not present transactions. This is not guaranteed, contact <a href=\"https:\/\/ca-test.adyen.com\/ca\/ca\/contactUs\/support.shtml?form=other\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">Support Team<\/a> to learn more.<\/p>\n<\/div>\n<\/li>\n<\/ol>\n<h3 id=\"avs-result-testing\">Test AVS results<\/h3>\n<p>To test your system's response to receiving an <code>avsResult<\/code>:<\/p>\n<ol>\n<li>Use our provided\u00a0<a href=\"\/pt\/development-resources\/testing\/risk-features\/#address-verification-system-avs\">AVS test cards and billing addresses<\/a>\u00a0or <a href=\"\/pt\/development-resources\/testing\/create-test-cards\">create your own test cards<\/a>.<\/li>\n<li>Include and define all the required\u00a0<code>billingAddress<\/code> parameters.<\/li>\n<li>Set the value of <code>street<\/code> to <strong>Test AVS result<\/strong>.<\/li>\n<li>Set the value of <code>houseNumberOrName<\/code> to the AVS response code\u00a0that you want to test from the <a href=\"#avs-mapping-table\">mapping table<\/a>. This table shows AVS response codes returned by Adyen, which are mapped to raw AVS response codes from acquirers.<\/li>\n<\/ol>\n<h2 id=\"avs-risk-rules\">Use AVS risk rules<\/h2>\n<p>When you use RevenueProtect, you can use and configure the standard <a href=\"\/pt\/risk-management\/configure-manual-risk\/standard-risk-rules#consistency-rules\">consistency risk rule<\/a> <strong>Billing address does not match cardholder address (AVS)<\/strong>. Alternatively, you can <a href=\"\/pt\/risk-management\/configure-manual-risk\/configure-custom-risk-rules\">configure custom risk rules<\/a> using AVS responses. In your custom rule, for the field <code>avsResponseCode<\/code>, you can use the Adyen response values from the <a href=\"#avs-mapping-table\">mapping table<\/a> to define the risk rule behavior.<\/p>\n<p>When you use Protect, you can use the Adyen-provided <a href=\"\/pt\/risk-management\/configure-your-risk-profile\/post-auth-rules\">Address Verification System (AVS)<\/a> rule, or create a post-authorization <a href=\"\/pt\/risk-management\/configure-your-risk-profile\/custom-rules\">custom rule<\/a>.<\/p>\n<h2 id=\"avs-mapping-table\">AVS responses and mapping<\/h2>\n<p>Different card brands and networks have specific AVS response codes. Many of them are mapped to the response codes that you receive from Adyen. We also have a number of Adyen AVS response codes to accommodate acquirers that send in slightly different raw AVS responses.<\/p>\n<p>For the mapping of AVS results for point-of-sale MOTO transactions with AVS, refer to <a href=\"\/pt\/point-of-sale\/avs-responses-pos\">AVS responses for point of sale<\/a>.<\/p>\n<p>If you prefer to receive the actual response code from the card or network, you can turn these on in your Customer Area:<\/p>\n<ol>\n<li>Log in to your <a href=\"https:\/\/ca-live.adyen.com\/\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">Customer Area<\/a>.<\/li>\n<li>Go to <strong>Developers<\/strong> &gt; <strong>Additional data<\/strong>.<\/li>\n<li>Select the <strong>Acquirer result<\/strong> and <strong>Raw acquirer result<\/strong> checkboxes.<\/li>\n<li>Select <strong>Save configuration<\/strong>.<\/li>\n<\/ol>\n<div class=\"notices blue\">\n<p>The Adyen AVS response in your test environment is a simulated value because the test payments are not processed via a live acquirer. In your live environment, you will receive both a raw AVS response from the acquirer, and the Adyen AVS response.<\/p>\n<\/div>\n<table>\n<thead>\n<tr>\n<th style=\"text-align: left;\">AVS Adyen response code<\/th>\n<th>Description<\/th>\n<th>AVS Raw response code<\/th>\n<th>Applies to<\/th>\n<th>Details<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td style=\"text-align: left;\"><strong>0<\/strong><\/td>\n<td>Unknown.<\/td>\n<td>-<\/td>\n<td>All issuers<\/td>\n<td>Adyen did not receive an answer from the issuing bank. You can allow or disallow transactions with an unknown AVS result through the <a href=\"\/pt\/risk-management\/configure-manual-risk\/standard-risk-rules#consistency-rules\">AVS consistency rule<\/a> options.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><strong>1<\/strong><\/td>\n<td>Address matches, but the postal code does not match.<\/td>\n<td><strong>A<\/strong><\/td>\n<td>Varies per card scheme<\/td>\n<td><p>Visa and Mastercard: Address matches, postal code does not.<\/p><p>American Express: Address only matches.<\/p><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><strong>2<\/strong><\/td>\n<td>Neither postal code nor address match.<\/td>\n<td><strong>N<\/strong><\/td>\n<td>Visa, Mastercard, Discover, American Express<\/td>\n<td>Neither address nor postal code matches.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><strong>3<\/strong><\/td>\n<td>AVS unavailable.<\/td>\n<td><strong>R<\/strong>, <strong>S<\/strong>, <strong>U<\/strong><\/td>\n<td>Visa, Mastercard, Discover, American Express<\/td>\n<td><p><strong>R<\/strong>: System unavailable or timed out. Discover: Not applicable.<\/p><p><strong>S<\/strong>: AVS currently not supported.<\/p><p><strong>U<\/strong>: No data from issuer\/Authorization Platform. Discover: System unavailable or timed out.<\/p><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><strong>4<\/strong><\/td>\n<td>AVS not supported for this card type.<\/td>\n<td>-<\/td>\n<td>Any credit card except Visa, Mastercard, Discover, American Express<\/td>\n<td>-<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><strong>5<\/strong><\/td>\n<td>No AVS data provided.<\/td>\n<td>-<\/td>\n<td>Visa, Mastercard, Discover, American Express<\/td>\n<td>-<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><strong>6<\/strong><\/td>\n<td><p>Postal code matches, but the address does not match.<\/p><\/td>\n<td><strong>T<\/strong>, <strong>W<\/strong>, <strong>Z<\/strong><\/td>\n<td>Varies per card scheme<\/td>\n<td><p><strong>T<\/strong>: Discover only: for U.S. addresses, nine-digit postal code matches, address does not.<\/p><p><strong>W<\/strong>: Mastercard only: For U.S. addresses, nine-digit postal code matches, address does not; for address outside the U.S., postal code matches, address does not.<\/p><p><strong>Z<\/strong>: Visa: for U.S. addresses, either five-digit or nine-digit postal code matches, address does not.<\/p><p><strong>Z<\/strong>: Mastercard and Discover: for U.S. addresses, five-digit postal code matches, address does not.<\/p><p><strong>Z<\/strong>: American Express: only postal code matches.<\/p><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><strong>7<\/strong><\/td>\n<td>Both postal code and address match.<\/td>\n<td><strong>A<\/strong>, <strong>D<\/strong>, <strong>F<\/strong>, <strong>M<\/strong>, <strong>X<\/strong>, <strong>Y<\/strong><\/td>\n<td>Varies per card scheme<\/td>\n<td><p><strong>A<\/strong>: Discover: Address and five-digit postal code match.<\/p><p><strong>D<\/strong>: Visa only. Street address and postal code match. <\/p><p><strong>F<\/strong>: Visa only. Street address and postal code match. Applies to U.K. only.<\/p><p><strong>M<\/strong>: Visa only. Street address and postal code match.<\/p><p><strong>X<\/strong>: Visa and American Express: not applicable.<\/p><p><strong>X<\/strong>: Mastercard: For U.S. addresses, all postal code digits match; for addresses outside the U.S., postal code and address match.<\/p><p><strong>X<\/strong>: Discover: For U.S. addresses, nine-digit postal code and address match.<\/p><p><strong>Y<\/strong>: Visa: For U.S. addresses, five-digit postal or nine-digit postal code matches.<\/p><p><strong>Y<\/strong>: Mastercard: For U.S. addresses, five-digit postal code and address matches.<\/p><p><strong>Y<\/strong>: Discover: Address only matches.<\/p><p><strong>Y<\/strong>: American Express: Postal code and address matches.<\/p><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><strong>8<\/strong><\/td>\n<td>Address not checked, postal code unknown.<\/td>\n<td>-<\/td>\n<td>Visa, Mastercard, Discover, American Express<\/td>\n<td>Only used for acquirers that do not use a standard AVS raw response.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><strong>9<\/strong><\/td>\n<td>Address matches, postal code unknown.<\/td>\n<td>-<\/td>\n<td>Visa, Mastercard, Discover, American Express<\/td>\n<td>Only used for acquirers that do not use a standard AVS raw response.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><strong>10<\/strong><\/td>\n<td>Address doesn't match, postal code unknown.<\/td>\n<td>-<\/td>\n<td>Visa, Mastercard, Discover, American Express<\/td>\n<td>Only used for acquirers that do not use a standard AVS raw response.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><strong>11<\/strong><\/td>\n<td>Postal code not checked, address unknown.<\/td>\n<td>-<\/td>\n<td>Visa, Mastercard, Discover, American Express<\/td>\n<td>Only used for acquirers that do not use a standard AVS raw response.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><strong>12<\/strong><\/td>\n<td>Address matches, postal code not checked.<\/td>\n<td><strong>B<\/strong><\/td>\n<td>Visa<\/td>\n<td>Street address match. Postal code not verified because of incompatible formats. (Acquirer sent both street address and postal code.)<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><strong>13<\/strong><\/td>\n<td>Address doesn't match, postal code not checked.<\/td>\n<td>-<\/td>\n<td>Visa, Mastercard, Discover, American Express<\/td>\n<td>Only used for acquirers that do not use a standard AVS raw response.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><strong>14<\/strong><\/td>\n<td><p>Postal code matches, address unknown.<\/p><\/td>\n<td>-<\/td>\n<td>Visa, Mastercard, Discover, American Express<\/td>\n<td>Only used for acquirers that do not use a standard AVS raw response.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><strong>15<\/strong><\/td>\n<td><p>Postal code matches, address not checked.<\/p><\/td>\n<td><strong>P<\/strong><\/td>\n<td>Visa<\/td>\n<td>Postal codes match. Street address not verified because of incompatible formats. (Acquirer sent both street address and postal code.)<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><strong>16<\/strong><\/td>\n<td>Postal code doesn't match, address unknown.<\/td>\n<td>-<\/td>\n<td>Visa, Mastercard, Discover, American Express<\/td>\n<td>Only used for acquirers that do not use a standard AVS raw response.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><strong>17<\/strong><\/td>\n<td>Postal code doesn't match, address not checked.<\/td>\n<td>-<\/td>\n<td>Visa, Mastercard, Discover, American Express<\/td>\n<td>Only used for acquirers that do not use a standard AVS raw response.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><strong>18<\/strong><\/td>\n<td>Neither postal code nor address were checked.<\/td>\n<td><strong>C<\/strong>, <strong>G<\/strong>, <strong>I<\/strong><\/td>\n<td>Visa<\/td>\n<td><p><strong>C<\/strong>: Street address and postal code not verified because of incompatible formats. (Acquirer sent both street address and postal code.)<\/p><p><strong>G<\/strong>: Non-AVS participant outside the U.S.; address not verified for international transaction.<\/p><p><strong>I<\/strong>: Address information not verified for international transaction.<p><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><strong>19<\/strong><\/td>\n<td>Name and postal code matches.<\/td>\n<td>-<\/td>\n<td>Visa, Mastercard, Discover, American Express<\/td>\n<td>Only used for acquirers that do not use a standard AVS raw response.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><strong>20<\/strong><\/td>\n<td>Name, address and postal code matches.<\/td>\n<td>-<\/td>\n<td>Visa, Mastercard, Discover, American Express<\/td>\n<td>Only used for acquirers that do not use a standard AVS raw response.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><strong>21<\/strong><\/td>\n<td>Name and address matches.<\/td>\n<td>-<\/td>\n<td>Visa, Mastercard, Discover, American Express<\/td>\n<td>Only used for acquirers that do not use a standard AVS raw response.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><strong>22<\/strong><\/td>\n<td>Name matches.<\/td>\n<td><strong>K<\/strong><\/td>\n<td>American Express<\/td>\n<td>Card member's name matches, but billing address and billing postal code do not match.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><strong>23<\/strong><\/td>\n<td><p>Postal code matches, name doesn't match.<\/p><\/td>\n<td>-<\/td>\n<td>Visa, Mastercard, Discover, American Express<\/td>\n<td>Only used for acquirers that do not use a standard AVS raw response.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><strong>24<\/strong><\/td>\n<td><p>Both postal code and address matches, name doesn't match.<\/p><\/td>\n<td>-<\/td>\n<td>Visa, Mastercard, Discover, American Express<\/td>\n<td>Only used for acquirers that do not use a standard AVS raw response.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><strong>25<\/strong><\/td>\n<td><p>Address matches, name doesn't match.<\/p><\/td>\n<td>-<\/td>\n<td>Visa, Mastercard, Discover, American Express<\/td>\n<td>Only used for acquirers that do not use a standard AVS raw response.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><strong>26<\/strong><\/td>\n<td>Neither postal code, address nor name matches.<\/td>\n<td>-<\/td>\n<td>Visa, Mastercard, Discover, American Express<\/td>\n<td>Only used for acquirers that do not use a standard AVS raw response.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h2>See also<\/h2>\n<div class=\"see-also-links output-inline\" id=\"see-also\">\n<ul><li><a href=\"\/development-resources\/testing\/risk-features\/#address-verification-system-avs\"\n                        target=\"_self\"\n                        >\n                    Test Address Verification System (AVS)\n                <\/a><\/li><li><a href=\"\/point-of-sale\/avs-responses-pos\"\n                        target=\"_self\"\n                        >\n                    AVS responses for point of sale\n                <\/a><\/li><\/ul><\/div>\n","url":"https:\/\/docs.adyen.com\/pt\/risk-management\/avs-checks","articleFields":{"description":"Set up and use Address Verification System (AVS) checks to reduce fraud risk. ","last_edit_on":"17-03-2023 12:10","feedback_component":true,"filters_component":false,"page_id":"7dc84064-d046-4b1d-9f4f-c169439c20ab","decision_tree":"[]"},"algolia":{"url":"https:\/\/docs.adyen.com\/pt\/risk-management\/avs-checks","title":"Address Verification System (AVS)","content":"The Address Verification System (AVS) is a service that verifies if a billing address matches the address of a credit card cardholder. AVS is a widely used fraud-prevention measure for Card Not Present (CNP) transactions, such as online payments or point-of-sale Mail Order\/Telephone Order (MOTO) payments.\nAVS gives you a way to check if the shopper who is placing the order is the same person as the cardholder, which is more likely if the billing address details match.\nHow does AVS work?\nWhen a shopper pays for a transaction, you can collect their billing address details. Then, you send that data in the billingAddress object in the payment authorization request. When you have enabled AVS, the system checks if and to what extent these billing address details match the information that the issuing bank has on file about the holder of the credit card.\nThe response to the payment request will contain an Adyen AVS response code that is mapped to a raw AVS response code. You can see the mapping in the mapping table.\nWhen the AVS check results in a mismatch, you can trigger a risk rule. When you use RevenueProtect, you can use the standard risk rule Billing address does not match cardholder address, or create a custom risk rule. When you use Protect, you can use the Adyen-provided Address Verification System (AVS) rule, or create a custom post-authorization rule.\nBased on the AVS response, you can decide what to do with the payment: you can accept, make an exception, or cancel a transaction.\nAVS is supported for card payments with Visa, Mastercard, Discover or American Express. Credit card issuers in the United States, Canada, the United Kingdom, and Europe (Visa only) must support AVS verification requests when you send them in, however, using AVS is not mandatory for you as a merchant.\nEnable and test AVS\nTo be able to trigger AVS and the AVS risk rules, you set up your payment authorization requests to include billing address details. How you do that depends on your integration. Follow the instructions below that are relevant for you.\nAVS in API requests\n\n\nCollect the shopper's billing address.\n\nCheckout: Make sure that you collect the shopper's billing address details to include them in the payment request. If you are using a client-side integration for Web, the Web Drop-in and Card Component can be configured to collect your shopper's billing address.\nClassic integration: Make sure that you collect the shopper's billing address details to include them in the  \/authorise request.\n\n\n\nSend the collected billing address information in the payment authorization request. Provide the full address of the shopper using the billingAddress child element:\n\nWhen you submit the\u00a0billingAddress\u00a0object for AVS, the following child elements are required:\n\n\n\n\nField\nType\nRequired\nDescription\n\n\n\n\ncountry\nString\n\nThe country value format needs to adhere to the ISO 3166-1 alpha-2 standard.\u00a0An invalid country code results in a transaction\/request rejection.\u00a0You can look up country codes on the ISO website.\n\n\ncity\nString\n\nThe name of the city.\n\n\nstreet\nString\n\nThe name of the street.\n\n\nhouseNumberOrName\nString\n\nThe number or name of the house.\n\n\npostalCode\nString\n\nA maximum of five digits for an address in the US, or a maximum of ten characters for an address in all other countries\/regions.\n\n\nstateOrProvince\nString\n\nRequired for shoppers from the US or Canada. Provide the child element stateOrProvince as defined in ISO 3166-2. For example, CA in the US or ON for Canada. AVS does not validate stateOrProvince.\n\n\n\n\nPass address lines, like apartment or unit number, as part of street.\nIf you do not know the country\/region or are not collecting the country\/region from the shopper, provide country as ZZ.\n\n\nTo qualify for better interchange rates submit the billing address and ZIP code for card not present transactions. This is not guaranteed, contact Support Team to learn more.\n\n\n\nTest AVS results\nTo test your system's response to receiving an avsResult:\n\nUse our provided\u00a0AVS test cards and billing addresses\u00a0or create your own test cards.\nInclude and define all the required\u00a0billingAddress parameters.\nSet the value of street to Test AVS result.\nSet the value of houseNumberOrName to the AVS response code\u00a0that you want to test from the mapping table. This table shows AVS response codes returned by Adyen, which are mapped to raw AVS response codes from acquirers.\n\nUse AVS risk rules\nWhen you use RevenueProtect, you can use and configure the standard consistency risk rule Billing address does not match cardholder address (AVS). Alternatively, you can configure custom risk rules using AVS responses. In your custom rule, for the field avsResponseCode, you can use the Adyen response values from the mapping table to define the risk rule behavior.\nWhen you use Protect, you can use the Adyen-provided Address Verification System (AVS) rule, or create a post-authorization custom rule.\nAVS responses and mapping\nDifferent card brands and networks have specific AVS response codes. Many of them are mapped to the response codes that you receive from Adyen. We also have a number of Adyen AVS response codes to accommodate acquirers that send in slightly different raw AVS responses.\nFor the mapping of AVS results for point-of-sale MOTO transactions with AVS, refer to AVS responses for point of sale.\nIf you prefer to receive the actual response code from the card or network, you can turn these on in your Customer Area:\n\nLog in to your Customer Area.\nGo to Developers &gt; Additional data.\nSelect the Acquirer result and Raw acquirer result checkboxes.\nSelect Save configuration.\n\n\nThe Adyen AVS response in your test environment is a simulated value because the test payments are not processed via a live acquirer. In your live environment, you will receive both a raw AVS response from the acquirer, and the Adyen AVS response.\n\n\n\n\nAVS Adyen response code\nDescription\nAVS Raw response code\nApplies to\nDetails\n\n\n\n\n0\nUnknown.\n-\nAll issuers\nAdyen did not receive an answer from the issuing bank. You can allow or disallow transactions with an unknown AVS result through the AVS consistency rule options.\n\n\n1\nAddress matches, but the postal code does not match.\nA\nVaries per card scheme\nVisa and Mastercard: Address matches, postal code does not.American Express: Address only matches.\n\n\n2\nNeither postal code nor address match.\nN\nVisa, Mastercard, Discover, American Express\nNeither address nor postal code matches.\n\n\n3\nAVS unavailable.\nR, S, U\nVisa, Mastercard, Discover, American Express\nR: System unavailable or timed out. Discover: Not applicable.S: AVS currently not supported.U: No data from issuer\/Authorization Platform. Discover: System unavailable or timed out.\n\n\n4\nAVS not supported for this card type.\n-\nAny credit card except Visa, Mastercard, Discover, American Express\n-\n\n\n5\nNo AVS data provided.\n-\nVisa, Mastercard, Discover, American Express\n-\n\n\n6\nPostal code matches, but the address does not match.\nT, W, Z\nVaries per card scheme\nT: Discover only: for U.S. addresses, nine-digit postal code matches, address does not.W: Mastercard only: For U.S. addresses, nine-digit postal code matches, address does not; for address outside the U.S., postal code matches, address does not.Z: Visa: for U.S. addresses, either five-digit or nine-digit postal code matches, address does not.Z: Mastercard and Discover: for U.S. addresses, five-digit postal code matches, address does not.Z: American Express: only postal code matches.\n\n\n7\nBoth postal code and address match.\nA, D, F, M, X, Y\nVaries per card scheme\nA: Discover: Address and five-digit postal code match.D: Visa only. Street address and postal code match. F: Visa only. Street address and postal code match. Applies to U.K. only.M: Visa only. Street address and postal code match.X: Visa and American Express: not applicable.X: Mastercard: For U.S. addresses, all postal code digits match; for addresses outside the U.S., postal code and address match.X: Discover: For U.S. addresses, nine-digit postal code and address match.Y: Visa: For U.S. addresses, five-digit postal or nine-digit postal code matches.Y: Mastercard: For U.S. addresses, five-digit postal code and address matches.Y: Discover: Address only matches.Y: American Express: Postal code and address matches.\n\n\n8\nAddress not checked, postal code unknown.\n-\nVisa, Mastercard, Discover, American Express\nOnly used for acquirers that do not use a standard AVS raw response.\n\n\n9\nAddress matches, postal code unknown.\n-\nVisa, Mastercard, Discover, American Express\nOnly used for acquirers that do not use a standard AVS raw response.\n\n\n10\nAddress doesn't match, postal code unknown.\n-\nVisa, Mastercard, Discover, American Express\nOnly used for acquirers that do not use a standard AVS raw response.\n\n\n11\nPostal code not checked, address unknown.\n-\nVisa, Mastercard, Discover, American Express\nOnly used for acquirers that do not use a standard AVS raw response.\n\n\n12\nAddress matches, postal code not checked.\nB\nVisa\nStreet address match. Postal code not verified because of incompatible formats. (Acquirer sent both street address and postal code.)\n\n\n13\nAddress doesn't match, postal code not checked.\n-\nVisa, Mastercard, Discover, American Express\nOnly used for acquirers that do not use a standard AVS raw response.\n\n\n14\nPostal code matches, address unknown.\n-\nVisa, Mastercard, Discover, American Express\nOnly used for acquirers that do not use a standard AVS raw response.\n\n\n15\nPostal code matches, address not checked.\nP\nVisa\nPostal codes match. Street address not verified because of incompatible formats. (Acquirer sent both street address and postal code.)\n\n\n16\nPostal code doesn't match, address unknown.\n-\nVisa, Mastercard, Discover, American Express\nOnly used for acquirers that do not use a standard AVS raw response.\n\n\n17\nPostal code doesn't match, address not checked.\n-\nVisa, Mastercard, Discover, American Express\nOnly used for acquirers that do not use a standard AVS raw response.\n\n\n18\nNeither postal code nor address were checked.\nC, G, I\nVisa\nC: Street address and postal code not verified because of incompatible formats. (Acquirer sent both street address and postal code.)G: Non-AVS participant outside the U.S.; address not verified for international transaction.I: Address information not verified for international transaction.\n\n\n19\nName and postal code matches.\n-\nVisa, Mastercard, Discover, American Express\nOnly used for acquirers that do not use a standard AVS raw response.\n\n\n20\nName, address and postal code matches.\n-\nVisa, Mastercard, Discover, American Express\nOnly used for acquirers that do not use a standard AVS raw response.\n\n\n21\nName and address matches.\n-\nVisa, Mastercard, Discover, American Express\nOnly used for acquirers that do not use a standard AVS raw response.\n\n\n22\nName matches.\nK\nAmerican Express\nCard member's name matches, but billing address and billing postal code do not match.\n\n\n23\nPostal code matches, name doesn't match.\n-\nVisa, Mastercard, Discover, American Express\nOnly used for acquirers that do not use a standard AVS raw response.\n\n\n24\nBoth postal code and address matches, name doesn't match.\n-\nVisa, Mastercard, Discover, American Express\nOnly used for acquirers that do not use a standard AVS raw response.\n\n\n25\nAddress matches, name doesn't match.\n-\nVisa, Mastercard, Discover, American Express\nOnly used for acquirers that do not use a standard AVS raw response.\n\n\n26\nNeither postal code, address nor name matches.\n-\nVisa, Mastercard, Discover, American Express\nOnly used for acquirers that do not use a standard AVS raw response.\n\n\n\nSee also\n\n\n                    Test Address Verification System (AVS)\n                \n                    AVS responses for point of sale\n                \n","type":"page","locale":"pt","boost":18,"hierarchy":{"lvl0":"Home","lvl1":"Risk management","lvl2":"Address Verification System (AVS)"},"hierarchy_url":{"lvl0":"https:\/\/docs.adyen.com\/pt","lvl1":"https:\/\/docs.adyen.com\/pt\/risk-management","lvl2":"\/pt\/risk-management\/avs-checks"},"levels":3,"category":"Risk Management","category_color":"green","tags":["Address","Verification","System","(AVS)"]}}
