{"title":"AVS responses for point of sale","category":"default","creationDate":1672051380,"content":"<p>For risk management purposes, you can add an Address Verification System (AVS) check to <a href=\"\/point-of-sale\/mail-and-telephone-order-moto\">Mail Order\/Telephone Order (MOTO)<\/a> payments. The payment terminal then prompts you to enter the shopper's postal code (zip code) and house number. The card issuer validates the data you entered and returns a response that can help you decide whether to go ahead with the transaction or cancel the authorization.<\/p>\n<p>We map the AVS responses we receive from card issuers to the following AVS results that can appear in your payment response, in the <code>avsResult<\/code> element of the <code>AdditionalResponse<\/code>. When we do not receive a response from the issuing bank, the AVS result is \"Unknown\".<\/p>\n<h2>Requirements<\/h2>\n<p>Before you begin, take into account the following requirements and limitations.<\/p>\n<table>\n<thead>\n<tr>\n<th style=\"text-align: left;\">Requirement<\/th>\n<th style=\"text-align: left;\">Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td style=\"text-align: left;\"><strong>Integration type<\/strong><\/td>\n<td style=\"text-align: left;\">A <a href=\"\/point-of-sale\/basic-tapi-integration\/\">Terminal API<\/a> integration with payment terminals or a <a href=\"\/point-of-sale\/standalone\">standalone solution<\/a>.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><strong>Limitations<\/strong><\/td>\n<td style=\"text-align: left;\">Take into account the following limitations: <ul><li> <a href=\"#avs\">Address verification service<\/a> is supported by American Express, Discover, Mastercard, and Visa. In the US, UK, and Canada, all other issuers also support it.<\/li><li><a href=\"#avs\">Address verification service<\/a> checks are not supported on Android payment terminals and legacy payment terminals. <\/li><\/ul><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h2>AVS responses<\/h2>\n<table>\n<thead>\n<tr>\n<th style=\"text-align: left;\">AVS code<\/th>\n<th style=\"text-align: left;\">AVS result<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td style=\"text-align: left;\">0<\/td>\n<td style=\"text-align: left;\">Unknown<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">1<\/td>\n<td style=\"text-align: left;\">Address matches, postal code doesn't<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">2<\/td>\n<td style=\"text-align: left;\">Neither postal code nor address match<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">3<\/td>\n<td style=\"text-align: left;\">AVS unavailable<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">4<\/td>\n<td style=\"text-align: left;\">AVS not supported for this card type<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">5<\/td>\n<td style=\"text-align: left;\">No AVS data provided<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">6<\/td>\n<td style=\"text-align: left;\">Postal code matches<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">7<\/td>\n<td style=\"text-align: left;\">Both postal code and address match<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">8<\/td>\n<td style=\"text-align: left;\">Address not checked, postal code unknown<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">9<\/td>\n<td style=\"text-align: left;\">Address matches, postal code unknown<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">10<\/td>\n<td style=\"text-align: left;\">Address doesn't match, postal code unknown<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">11<\/td>\n<td style=\"text-align: left;\">Postal code not checked, address unknown<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">12<\/td>\n<td style=\"text-align: left;\">Address matches, postal code not checked<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">13<\/td>\n<td style=\"text-align: left;\">Address doesn't match, postal code not checked<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">14<\/td>\n<td style=\"text-align: left;\">Postal code matches<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">15<\/td>\n<td style=\"text-align: left;\">Postal code matches<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">16<\/td>\n<td style=\"text-align: left;\">Postal code doesn't match, address unknown<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">17<\/td>\n<td style=\"text-align: left;\">Postal code doesn't match, address not checked<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">18<\/td>\n<td style=\"text-align: left;\">Neither postal code nor address were checked<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">23<\/td>\n<td style=\"text-align: left;\">Postal code matches<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">24<\/td>\n<td style=\"text-align: left;\">Both postal code and address match<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">25<\/td>\n<td style=\"text-align: left;\">Address matches<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">26<\/td>\n<td style=\"text-align: left;\">Neither postal code, address nor name match<\/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=\"\/point-of-sale\/mail-and-telephone-order-moto\"\n                        target=\"_self\"\n                        >\n                    Mail Order\/Telephone Order\n                <\/a><\/li><li><a href=\"\/risk-management\/avs-checks\"\n                        target=\"_self\"\n                        >\n                    Address Verification System (AVS)\n                <\/a><\/li><\/ul><\/div>\n","url":"https:\/\/docs.adyen.com\/point-of-sale\/mail-and-telephone-order-moto\/avs-responses-pos","articleFields":{"description":"Address verification system (AVS) responses for Mail Order\/Telephone Order payments.","feedback_component":true,"last_edit_on":"26-12-2022 11:44"},"algolia":{"url":"https:\/\/docs.adyen.com\/point-of-sale\/mail-and-telephone-order-moto\/avs-responses-pos","title":"AVS responses for point of sale","content":"For risk management purposes, you can add an Address Verification System (AVS) check to Mail Order\/Telephone Order (MOTO) payments. The payment terminal then prompts you to enter the shopper's postal code (zip code) and house number. The card issuer validates the data you entered and returns a response that can help you decide whether to go ahead with the transaction or cancel the authorization.\nWe map the AVS responses we receive from card issuers to the following AVS results that can appear in your payment response, in the avsResult element of the AdditionalResponse. When we do not receive a response from the issuing bank, the AVS result is \"Unknown\".\nRequirements\nBefore you begin, take into account the following requirements and limitations.\n\n\n\nRequirement\nDescription\n\n\n\n\nIntegration type\nA Terminal API integration with payment terminals or a standalone solution.\n\n\nLimitations\nTake into account the following limitations:  Address verification service is supported by American Express, Discover, Mastercard, and Visa. In the US, UK, and Canada, all other issuers also support it.Address verification service checks are not supported on Android payment terminals and legacy payment terminals. \n\n\n\nAVS responses\n\n\n\nAVS code\nAVS result\n\n\n\n\n0\nUnknown\n\n\n1\nAddress matches, postal code doesn't\n\n\n2\nNeither postal code nor address match\n\n\n3\nAVS unavailable\n\n\n4\nAVS not supported for this card type\n\n\n5\nNo AVS data provided\n\n\n6\nPostal code matches\n\n\n7\nBoth postal code and address match\n\n\n8\nAddress not checked, postal code unknown\n\n\n9\nAddress matches, postal code unknown\n\n\n10\nAddress doesn't match, postal code unknown\n\n\n11\nPostal code not checked, address unknown\n\n\n12\nAddress matches, postal code not checked\n\n\n13\nAddress doesn't match, postal code not checked\n\n\n14\nPostal code matches\n\n\n15\nPostal code matches\n\n\n16\nPostal code doesn't match, address unknown\n\n\n17\nPostal code doesn't match, address not checked\n\n\n18\nNeither postal code nor address were checked\n\n\n23\nPostal code matches\n\n\n24\nBoth postal code and address match\n\n\n25\nAddress matches\n\n\n26\nNeither postal code, address nor name match\n\n\n\nSee also\n\n\n                    Mail Order\/Telephone Order\n                \n                    Address Verification System (AVS)\n                \n","type":"page","locale":"en","boost":17,"hierarchy":{"lvl0":"Home","lvl1":"In-person payments","lvl2":"Mail Order\/Telephone Order (MOTO)","lvl3":"AVS responses for point of sale"},"hierarchy_url":{"lvl0":"https:\/\/docs.adyen.com\/","lvl1":"https:\/\/docs.adyen.com\/point-of-sale","lvl2":"https:\/\/docs.adyen.com\/point-of-sale\/mail-and-telephone-order-moto","lvl3":"\/point-of-sale\/mail-and-telephone-order-moto\/avs-responses-pos"},"levels":4,"category":"In-person payments","category_color":"green","tags":["responses","point"]}}
