Address Verification System (AVS) | Adyen Docs

Het Address Verification System (AVS) is een dienst die controleert of een factuuradres overeenkomt met het adres van een creditcardhouder. AVS is een veel gebruikte fraudepreventiemaatregel voor Card Not Present (CNP) transacties, zoals online betalingen of postorder-/telefoonbestelling (MOTO) betalingen op een verkooppunt.
AVS geeft u een manier om te controleren of de shopper die de bestelling plaatst dezelfde persoon is als de creditcardhouder, wat waarschijnlijker is als de factuuradresgegevens overeenkomen.

Hoe werkt AVS?

Wanneer een shopper betaalt voor een transactie, kunt u zijn factuuradresgegevens verzamelen. Vervolgens stuurt u die gegevens in het billingAddress object in het verzoek om toestemming voor de betaling. Als u AVS hebt ingeschakeld, controleert het systeem of en in hoeverre deze factuuradresgegevens overeenkomen met de creditcardhoudergegevens van de uitgevende bank in het bestand.

Het antwoord op het betalingsverzoek bevat een Adyen AVS-antwoordcode die is gemapt naar een raw AVS-antwoordcode. U kunt de mapping zien in de mapping tabel.

Wanneer de AVS check resulteert in een mismatch, kunt u een risk rule triggeren. U kunt de standaardrisicoregel Factuuradres komt niet overeen met adres van de kaarthouder gebruiken, of u kunt een aangepaste risicoregel maken. Op basis van de AVS-respons kunt u beslissen wat er met de betaling moet gebeuren: u kunt deze accepteren, een uitzondering maken of een transactie annuleren.

AVS wordt ondersteund voor kaartbetalingen met Visa, MasterCard, Discover of American Express. Creditcard-emittenten in de Verenigde Staten, Canada en het Verenigd Koninkrijk moeten AVS-verificatieverzoeken ondersteunen als u ze instuurt, maar het gebruik van AVS is voor u als handelaar niet verplicht.

Inschakelen en testen van AVS

Om AVS en de AVS-risicoregels te kunnen activeren, stelt u uw verzoeken voor betalingsautorisatie in om factuuradresgegevens op te nemen. Hoe u dat doet, hangt af van uw integratie. Volg de onderstaande instructies die voor u relevant zijn.

AVS in API-verzoeken

Verzamel het factuuradres van de shopper.
- Checkout API: Zorg ervoor dat je de factuuradresgegevens van de shopper verzamelt om ze op te nemen in het /payments-verzoek. Als u een client-side integratie voor Web gebruikt, kunnen de Web Drop-in en Card Component worden geconfigureerd om het factuuradres van uw shopper te verzamelen.
- Klassieke integratie: Zorg ervoor dat u de factuuradresgegevens van de shopper verzamelt om deze op te nemen in het /authorise-verzoek.

Verstuur de verzamelde factuuradresgegevens in het betalingsautorisatieverzoek. Geef het volledige adres van de shopper met behulp van het billingAddress child element:

{ "billingAddress": { "country":"US", "city":"SF", "street":"Example street", "houseNumberOrName":"40", "stateOrProvince":"CA", "postalCode":"91351" }}

<billingAddress xmlns="http://payment.services.adyen.com"> <country xmlns="http://common.services.adyen.com">US</country> <city xmlns="http://common.services.adyen.com">SF</city> <street xmlns="http://common.services.adyen.com">Example street</street> <houseNumberOrName xmlns="http://common.services.adyen.com">40</houseNumberOrName> <stateOrProvince xmlns="http://common.services.adyen.com">CA</stateOrProvince> <postalCode xmlns="http://common.services.adyen.com">91351</postalCode> </billingAddress>

billingAddress.country=US&billingAddress.street=Example+street&billingAddress.houseNumberOrName=40&billingAddress.postalCode=91351&billingAddress.stateOrProvince=CA&billingAddress.city=SF

Wanneer u het billingAddress object indient voor AVS, zijn de volgende child-elementen vereist:

Field	Type	Omschrijving
`country`	String	Het `country` waardeformaat moet voldoen aan de ISO 3166-1 alpha-2 norm. Een ongeldige landcode leidt tot afwijzing van de transactie/het verzoek. U kunt de landcodes opzoeken op de ISO-website.
`city`	String	De naam van de stad.
`street`	String	De naam van de straat.	`houseNumberOrName`	String	Het nummer of de naam van het huis.
`postalCode`	String	Niet meer dan vijf cijfers voor een adres in de VS, of niet meer dan tien tekens voor een adres in alle andere landen.
`stateOrProvince`	String	Verplicht voor shoppers uit het VK, de VS of Canada. Zorg voor het child element `stateOrProvince` zoals gedefinieerd in ISO 3166-2. Bijvoorbeeld CA voor de VS of ON voor Canada. AVS valideert `stateOrProvince` niet.

Pas adresregels, zoals appartement- of unitnummer, als onderdeel van street.
Als u het land niet weet of het land niet van de klant ophaalt, geef dan country op als ZZ.

Om in aanmerking te komen voor betere afwikkelingstarieven moet u het factuuradres en de postcode opgeven voor transacties waarbij de kaart niet aanwezig is. Dit is niet gegarandeerd. Neem contact op met het ondersteuningsteam voor meer informatie.

AVS voor Hosted Payment Pages (HPP)

Om AVS voor een HPP-skin in te schakelen:

Ga naar Klantengedeelte > Account > Skins.
Zoek en selecteer de skin die u wilt bewerken.
Onder Skinopties, schakel het selectievakje Factuuradresvelden (AVS) in.

De AVS-instelling is skin-specifiek. U moet deze voor elke skin inschakelen om AVS te kunnen toepassen.

Voor een lijst met parameters die voor deze oproep vereist zijn, raadpleegt u HPP-factuuradres en AVS-velden.

U kunt ervoor kiezen de HPP’s de factuuradresgegevens uit uw eigen systeem te laten voorinvullen, zoals hieronder getoond:

Test AVS-resultaten

Om de reactie van uw systeem op de ontvangst van een avsResult te testen:

Integreer en definieer alle vereiste billingAddress parameters.
Stel de waarde van street in op Test AVS resultaat.
Stel de waarde van houseNumberOrName in op de AVS antwoordcode die u wilt testen uit de mapping tabel. Deze tabel toont door Adyen geretourneerde AVS-responscodes, die zijn gemapt naar ruwe AVS-responscodes van acquirers.

Gebruik AVS-risicoregels

U kunt de standaardconsistentierisicoregel Factuuradres komt niet overeen met kaarthouderadres gebruiken en configureren.

Aternatief kunt u aangepaste risicoregels configureren met behulp van AVS-respons. In uw aangepaste regel kunt u voor het veld avsResponseCode de Adyen-responswaarden uit de mapping-tabel gebruiken om het gedrag van de risico-regel te definiëren.

AVS-reacties en mapping

Verschillende kaartmerken en netwerken hebben specifieke AVS-responscodes. Veel van deze codes zijn gekoppeld aan de responscodes die u van Adyen ontvangt. We hebben ook een aantal Adyen AVS-responscodes om tegemoet te komen aan acquirers die iets andere ruwe AVS-reacties insturen.

Voor de mapping van AVS-resultaten voor MOTO-transacties met AVS, zie AVS-reacties voor verkooppunten.

Als u liever de werkelijke responscode van de kaart of het netwerk ontvangt, kunt u deze in uw Klantenpagina inschakelen:

Log in op uw Klantenpagina.
Ga naar Account > API URL’s > Instellingen voor aanvullende gegevens.
Selecteer de selectievakjes Acquirer-resultaat en Raw acquirer-resultaat.

Als u problemen ondervindt, neem dan contact op met het Support Team.

Visa, MasterCard, Discover, American Express

AVS Adyen-antwoordcode	Beschrijving	AVS Raw-antwoord code	Geldt voor	Details
0	Onbekend.	–	Alle emittenten	Adyen heeft geen antwoord ontvangen van de emitterende bank. U kunt transacties met een onbekend AVS-resultaat toestaan of weigeren via de opties voor de AVS-consistentieregels.
1	Adres komt overeen, maar de postcode niet.	A	Varieert per kaartsysteem.	Visa en MasterCard: Adres komt overeen, postcode niet. American Express: Alleen adres komt overeen.
2	Niet postcode noch adres komt overeen.	N	Visa, MasterCard, Discover, American Express	Niet adres noch postcode komt overeen.
3	AVS niet beschikbaar.	R, S, U	Visa, MasterCard, Discover, American Express	R: Systeem niet beschikbaar of time-out. Discover: Niet van toepassing. S: AVS wordt momenteel niet ondersteund. U: Geen gegevens van emittent/Authorization Platform. Discover: Systeem niet beschikbaar of time-out.
4	AVS niet ondersteund voor dit kaarttype.	–	Elke kredietkaart behalve Visa, MasterCard, Discover, American Express	–
5	Geen AVS-gegevens verstrekt.	–	–
6	Postcode komt overeen, maar het adres niet.	T, W, Z	Varieert per kaartsysteem	T: alleen Discover: voor adressen in de V.S. komt de negencijferige postcode overeen, het adres niet. W: alleen MasterCard: Voor adressen in de V.S. komt de negencijferige postcode overeen, het adres niet; voor adressen buiten de V.S, komt postcode overeen, adres niet. Z: Visa: voor adressen in de V.S. komt vijf- of negencijferige postcode overeen, adres niet. Z: MasterCard en Discover: voor adressen in de V.S. komt vijfcijferige postcode overeen, adres niet. Z: American Express: alleen postcode komt overeen.
7	Bestaande postcode en adres komen overeen.	A, D, F, M, X, Y	Varieert per kaartsysteem	A: Discover: Adres en postcode van vijf cijfers komen overeen. D: Alleen Visa. Straatadres en postcode komen overeen. F: Alleen Visa. Straatadres en postcode komen overeen. Geldt alleen voor het Verenigd Koninkrijk. M: Alleen Visa. Straatadres en postcode komen overeen. X: Visa en American Express: niet van toepassing. X: MasterCard: Voor adressen in de V.S. komen alle postcodecijfers overeen; voor adressen buiten de V.S. komen postcode en adres overeen. X: Discover: Voor adressen in de Verenigde Staten komen de postcode en het adres met negen cijfers overeen. Y: Visa: Voor adressen in de VS moet de postcode van vijf of negen cijfers overeenkomen. Y: MasterCard: Voor adressen in de VS komen de postcode van vijf cijfers en het adres overeen. Y: Discover: Alleen adres komt overeen. Y: American Express: Postcode en adres komt overeen.
8	Adres niet gecontroleerd, postcode onbekend.	–	Visa, MasterCard, Discover, American Express	Alleen gebruikt voor acquirers die geen standaard AVS raw response gebruiken.
9	Adres komt overeen, postcode onbekend.	–	Visa, MasterCard, Discover, American Express	Alleen gebruikt voor acquirers die niet een standaard AVS raw response gebruiken.
10	Adres komt niet overeen, postcode onbekend.	–	Alleen gebruikt voor acquirers die geen standaard AVS raw response gebruiken.
11	Postcode niet gecontroleerd, adres onbekend.	–	Visa, MasterCard, Discover, American Express	Alleen gebruikt voor acquirers die geen standaard AVS raw response gebruiken.
12	Adres komt overeen, postcode niet gecontroleerd.	B	Visa	Straatadres komt overeen. Postcode niet geverifieerd vanwege incompatibele formaten. (Acquirer stuurde zowel straatadres als postcode.)
13	Adres komt niet overeen, postcode niet gecontroleerd.	–	Alleen gebruikt voor acquirers die geen standaard AVS raw response gebruiken.
14	Postcode komt overeen, adres onbekend.	–	Visa, MasterCard, Discover, American Express	Alleen gebruikt voor acquirers die geen standaard AVS raw response gebruiken.
15	Postcode komt overeen, adres niet gecontroleerd.	P	Visa	Postcodes komen overeen. Straatadres niet geverifieerd vanwege incompatibele formaten. (Acquirer stuurde zowel straatadres als postcode.)
16	Postcode komt niet overeen, adres onbekend.	–	Visa, MasterCard, Discover, American Express	Alleen gebruikt voor acquirers die geen standaard AVS raw response gebruiken.
17	Postcode komt niet overeen, adres niet gecontroleerd.	–	Visa, MasterCard, Discover, American Express	Alleen gebruikt voor acquirers die geen standaard AVS raw response gebruiken.
18	Niet de postcode noch het adres werden gecontroleerd.	C, G, I	Visa	C: Straatadres en postcode niet geverifieerd wegens incompatibele formaten. (Acquirer stuurde zowel straatadres als postcode.) G: Niet-AVS deelnemer buiten de V.S.; adres niet geverifieerd voor internationale transactie. I: Adresinformatie niet geverifieerd voor internationale transactie.
19	Naam en postcode komen overeen.	–	Alleen gebruikt voor acquirers die geen standaard AVS raw response gebruiken.
20	Naam, adres en postcode komen overeen.	–	Alleen gebruikt voor acquirers die geen standaard AVS raw response gebruiken.
21	Naam en adres komt overeen.	–	Alleen gebruikt voor acquirers die geen standaard AVS raw response gebruiken.
22	Naam komt overeen.	K	American Express	De naam van het kaartlid komt overeen, maar het factuuradres en de factuuradrescode komen niet overeen.
23	Postcode komt overeen, naam niet.	–	Visa, MasterCard, Discover, American Express	Alleen gebruikt voor acquirers die geen standaard AVS raw-respons gebruiken.
24	Bestemming postcode en adres, naam komt niet overeen.	–	Visa, MasterCard, Discover, American Express	Alleen gebruikt voor acquirers die geen gebruik maken van een standaard AVS raw-respons.
25	Adres komt overeen, naam niet.	–	Visa, MasterCard, Discover, American Express	Alleen gebruikt voor acquirers die geen standaard AVS raw-respons gebruiken.
26	Geen van beide komt overeen met postcode, adres of naam.	–	Visa, MasterCard, Discover, American Express	Alleen gebruikt voor acquirers die geen standaard ruwe AVS-respons gebruiken.

Adress Verification System (AVS)