Address Verification System (AVS) | Adyen Docs

Das Address Verification System (AVS) ist ein Dienst, der prüft, ob eine Rechnungsadresse mit der Adresse eines Kreditkarteninhabers übereinstimmt. AVS ist eine weit verbreitete Maßnahme zur Betrugsprävention bei Card Not Present (CNP)-Transaktionen, wie z. B. bei Online-Zahlungen oder Point-of-Sale Mail Order/Telephone Order (MOTO)-Zahlungen.
AVS gibt Ihnen die Möglichkeit zu prüfen, ob der Käufer, der die Bestellung aufgibt, die gleiche Person ist wie der Kreditkarteninhaber, was wahrscheinlicher ist, wenn die Rechnungsadressdaten übereinstimmen.

Wie funktioniert AVS?

Wenn ein Käufer für eine Transaktion bezahlt, können Sie seine Rechnungsadressdaten erfassen. Dann senden Sie diese Daten im billingAddress-Objekt in der Zahlungsanforderung. Wenn Sie AVS aktiviert haben, prüft das System, ob und inwieweit diese Rechnungsadressdaten mit den Kreditkarteninhaberdaten der ausstellenden Bank übereinstimmen.

Die Antwort auf die Zahlungsanforderung enthält einen Adyen AVS-Antwortcode, der auf einen rohen AVS-Antwortcode abgebildet wird. Sie können das Mapping in der Mapping-Tabelle sehen.

Wenn die AVS-Prüfung eine Fehlanpassung ergibt, können Sie eine Risikoregel auslösen. Sie können die Standard-Risikoregel Rechnungsadresse stimmt nicht mit der Adresse des Karteninhabers überein verwenden, oder Sie können eine benutzerdefinierte Risikoregel erstellen. Basierend auf der AVS-Antwort können Sie entscheiden, was mit der Zahlung geschehen soll: Sie können sie akzeptieren, eine Ausnahme machen oder die Transaktion abbrechen.

AVS wird für Kartenzahlungen mit Visa, MasterCard, Discover oder American Express unterstützt. Kreditkartenherausgeber in den USA, Kanada und Großbritannien müssen AVS-Verifizierungsanfragen unterstützen, wenn Sie diese einsenden. Die Verwendung von AVS ist für Sie als Händler jedoch nicht zwingend erforderlich.

Aktivieren und testen Sie AVS

Um AVS und die AVS-Risikoregeln auslösen zu können, richten Sie Ihre Zahlungsautorisierungsanfragen so ein, dass sie Angaben zur Rechnungsadresse enthalten. Wie Sie das tun, hängt von Ihrer Integration ab. Folgen Sie den folgenden Anweisungen, die für Sie relevant sind.

AVS in API-Anfragen

Erfassen Sie die Rechnungsadresse des Käufers.
- Checkout API: Stellen Sie sicher, dass Sie die Rechnungsadressdaten des Käufers sammeln, um sie in die /payments-Anfrage aufzunehmen. Wenn Sie eine clientseitige Integration für das Web verwenden, können das Web Drop-in und die Kartenkomponente so konfiguriert werden, dass die Rechnungsadresse des Käufers erfasst wird.
- Klassische Integration: Stellen Sie sicher, dass Sie die Rechnungsadressdaten des Käufers erfassen, um sie in die /authorise-Anforderung aufzunehmen.

Senden Sie die erfassten Rechnungsadressdaten in der Zahlungsautorisierungsanforderung. Geben Sie die vollständige Adresse des Käufers mithilfe des billingAddress-Kinderelements an:

{ "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

Wenn Sie das billingAddress Objekt für AVS, sind die folgenden Kindelemente erforderlich:

Feld	Typ	Beschreibung
`country`	String	Das `country` Werteformat muss dem ISO 3166-1 alpha-2 Standard entsprechen. Ein ungültiger Ländercode führt zu einer Ablehnung der Transaktion/Anfrage. Sie können die Ländercodes auf der ISO-Website nachschlagen.
`city`	String	Der Name der Stadt.
`street`	String	Der Name der Straße.
`houseNumberOrName`	String	Die Nummer oder der Name des Hauses.
`postalCode`	String	Maximal fünf Ziffern für eine Adresse in den USA, oder maximal zehn Zeichen für eine Adresse in allen anderen Ländern.
`stateOrProvince`	String	Erforderlich für Käufer aus Großbritannien, den USA oder Kanada. Geben Sie das Kindelement `stateOrProvince` gemäß der Definition in ISO 3166-2 an. Zum Beispiel, CA in US oder ON für Kanada. AVS validiert `stateOrProvince` nicht.

Übergeben Sie Adresszeilen, wie z.B. Wohnungs- oder Einheitsnummer, als Teil von street.
Wenn Sie das Land nicht kennen oder nicht vom Käufer erheben, geben Sie country als ZZ an.

Um sich für bessere Interchange-Raten zu qualifizieren, geben Sie die Rechnungsadresse und die Postleitzahl für „card not present“-Transaktionen an. Dies ist nicht garantiert, kontaktieren Sie den Support, um mehr zu erfahren.

AVS für Hosted Payment Pages (HPP)

Um AVS für ein HPP-Skin zu aktivieren:

Gehen Sie zum Kundenbereich > Konto > Skins.
Suchen und wählen Sie diejenige aus, die Sie bearbeiten möchten.
Unter Skin-Optionen aktivieren Sie das Kontrollkästchen Rechnungsadressfelder (AVS).

Die AVS-Einstellung ist skin-spezifisch. Sie müssen sie für jedes Skin aktivieren, um AVS anzuwenden.

Eine Liste der für diesen Aufruf erforderlichen Parameter finden Sie unter HPP-Rechnungsadress- und AVS-Felder.

Sie können die HPPs die Rechnungsadressinformationen aus Ihrem eigenen System vorausfüllen lassen, wie unten gezeigt:

Testen Sie die AVS-Ergebnisse

Um die Reaktion Ihres Systems auf den Empfang eines avsResult zu testen:

Verwenden Sie unsere mitgelieferten AVS-Testkarten und Rechnungsadressen oder erstellen Sie Ihre eigenen Testkarten.
Fügen Sie alle erforderlichen billingAddress Parameter ein und definieren Sie sie.
Setzen Sie den Wert von street auf das AVS-Testergebnis.
Setzen Sie den Wert von houseNumberOrName auf den AVS-Antwortcode, den Sie aus der Zuordnungstabelle testen möchten. Diese Tabelle zeigt die von Adyen zurückgegebenen AVS-Antwortcodes, die den rohen AVS-Antwortcodes von Acquirern zugeordnet sind.

Verwenden Sie AVS-Risikoregeln

Sie können die Standardkonsistenz-Risikoregel Rechnungsadresse stimmt nicht mit Karteninhaberadresse überein verwenden und konfigurieren.

Alternativ können Sie benutzerdefinierte Risikoregeln unter Verwendung von AVS-Antworten konfigurieren. In Ihrer benutzerdefinierten Regel können Sie für das Feld avsResponseCode die Adyen-Antwortwerte aus der Mapping-Tabelle verwenden, um das Verhalten der Risikoregel zu definieren.

AVS-Antworten und Mapping

Die verschiedenen Kartenmarken und Netzwerke haben spezifische AVS-Antwortcodes. Viele von ihnen sind den Antwortcodes zugeordnet, die Sie von Adyen erhalten. Wir haben auch eine Reihe von Adyen AVS-Antwortcodes, um Acquirern entgegenzukommen, die leicht abweichende rohe AVS-Antworten senden.

Für das Mapping von AVS-Ergebnissen für MOTO-Transaktionen am Point-of-Sale mit AVS siehe AVS-Antworten für Point-of-Sale.

Wenn Sie es vorziehen, den tatsächlichen Antwortcode von der Karte oder dem Netzwerk zu erhalten, können Sie diese in Ihrem Kundenbereich aktivieren:

Loggen Sie sich in Ihren Kundenbereich ein.
Gehen Sie zu Konto > API URLs > Zusätzliche Dateneinstellungen.
Aktivieren Sie die Kontrollkästchen Acquirer-Ergebnis und Raw Acquirer-Ergebnis.

Sollten Sie Probleme haben, wenden Sie sich an den Support.

AVS Adyen-Antwortcode	Beschreibung	AVS Raw-Antwort code	Gilt für	Details
0	Unbekannt.	–	Alle Emittenten	Adyen hat keine Antwort von der emittierenden Bank erhalten. Sie können Transaktionen mit einem unbekannten AVS-Ergebnis über die Optionen der AVS-Konsistenzregel zulassen oder verbieten.
1	Die Adresse stimmt überein, aber die Postleitzahl stimmt nicht überein.	A	Variiert pro Kartenprogramm	Visa und MasterCard: Adresse stimmt überein, Postleitzahl nicht. American Express: Nur Adresse stimmt überein.
2	Weder Postleitzahl noch Adresse stimmen überein.	N	Visa, MasterCard, Discover, American Express	Weder Adresse noch Postleitzahl stimmen überein.
3	AVS nicht verfügbar.	R, S, U	Visa, MasterCard, Discover, American Express	R: System nicht verfügbar oder Zeitüberschreitung. Discover: Nicht anwendbar. S: AVS wird derzeit nicht unterstützt. U: Keine Daten vom Emittenten/Autorisierungsplattform. Discover: System nicht verfügbar oder Zeitüberschreitung.
4	AVS wird für diesen Kartentyp nicht unterstützt.	–	Beliebige Kreditkarte außer Visa, MasterCard, Discover, American Express	–
5	Keine AVS-Daten bereitgestellt.	–	Visa, MasterCard, Discover, American Express	–
6	Postleitzahl stimmt überein, aber die Adresse stimmt nicht überein.	T, W, Z	Variiert pro Kartensystem	T: Nur Discover: Für US-Adressen, neunstellige Postleitzahl stimmt überein, Adresse stimmt nicht überein. W: Nur MasterCard: Für US-Adressen, neunstellige Postleitzahl stimmt überein, Adresse nicht; für Adressen außerhalb der USA, Postleitzahl stimmt überein, Adresse nicht. Z: Visa: für US-Adressen, entweder fünf- oder neunstellige Postleitzahl stimmt überein, Adresse nicht. Z: MasterCard und Discover: für US-Adressen, fünfstellige Postleitzahl stimmt überein, Adresse nicht. Z: American Express: nur die Postleitzahl stimmt überein.
7	Beide, Postleitzahl und Adresse, stimmen überein.	A, D, F, M, X, Y	Variiert pro Kartensystem	A: Discover: Adresse und fünfstellige Postleitzahl stimmen überein. D: Nur Visa. Adresse und Postleitzahl stimmen überein. F: Nur Visa. Straßenadresse und Postleitzahl stimmen überein. Gilt nur für Großbritannien. M: Nur Visa. Straßenadresse und Postleitzahl stimmen überein. X: Visa und American Express: nicht anwendbar. X: MasterCard: Bei US-Adressen stimmen alle Postleitzahlstellen überein; bei Adressen außerhalb der USA stimmen Postleitzahl und Adresse überein. X: Discover: Für Adressen in den USA stimmen neunstellige Postleitzahl und Adresse überein. Y: Visa: Für U.S.-Adressen, fünfstellige Postleitzahl oder neunstellige Postleitzahl stimmt überein. Y: MasterCard: Für U.S.-Adressen, fünfstellige Postleitzahl und Adresse passt. Y: Discover: Nur Adresse stimmt überein. Y: American Express: Postleitzahl und Adresse stimmt überein.
8	Adresse nicht geprüft, Postleitzahl unbekannt.	–	Visa, MasterCard, Discover, American Express	Nur für Acquirer verwendet, die keine Standard-AVS-Rohantwort verwenden.
9	Adresse stimmt überein, Postleitzahl unbekannt.	–	Visa, MasterCard, Discover, American Express	Nur für Acquirer verwendet, die keine Standard-AVS-Rohantwort verwenden.
10	Adresse stimmt nicht überein, Postleitzahl unbekannt.	–	Visa, MasterCard, Discover, American Express	Nur für Acquirer verwendet, die keine Standard-AVS-Rohantwort verwenden.
11	Postleitzahl nicht geprüft, Adresse unbekannt.	–	Visa, MasterCard, Discover, American Express	Nur verwendet für Acquirer, die keine Standard-AVS-Rohantwort verwenden.
12	Adresse stimmt überein, Postleitzahl nicht geprüft.	B	Visa	Straßenadresse stimmt überein. Postleitzahl nicht geprüft, da inkompatible Formate. (Acquirer hat sowohl Straßenadresse als auch Postleitzahl gesendet.)
13	Adresse stimmt nicht überein, Postleitzahl nicht geprüft.	–	Visa, MasterCard, Discover, American Express	Nur für Acquirer verwendet, die keine Standard-AVS-Rohantwort verwenden.
14	Postleitzahl stimmt überein, Adresse unbekannt.	–	Visa, MasterCard, Discover, American Express	Nur verwendet für Acquirer, die keine Standard-AVS-Rohantwort verwenden.
15	Postleitzahl stimmt überein, Adresse nicht geprüft.	P	Visa	Postleitzahlen stimmen überein. Straßenadresse nicht geprüft, da inkompatible Formate. (Erwerber hat sowohl Straßenadresse als auch Postleitzahl gesendet.)
16	Postleitzahl stimmt nicht überein, Adresse unbekannt.	–	Visa, MasterCard, Discover, American Express	Nur für Acquirer verwendet, die keine Standard-AVS-Rohantwort verwenden.
17	Postleitzahl stimmt nicht überein, Adresse nicht geprüft.	–	Visa, MasterCard, Discover, American Express	Nur für Acquirer verwendet, die keine Standard-AVS-Rohantwort verwenden.
18	Weder Postleitzahl noch Adresse wurden überprüft.	C, G, I	Visa	C: Straßenadresse und Postleitzahl wurden aufgrund inkompatibler Formate nicht überprüft. (Acquirer hat sowohl Straßenadresse als auch Postleitzahl gesendet.) G: Nicht-AVS-Teilnehmer außerhalb der USA; Adresse nicht für internationale Transaktion verifiziert. I: Adressinformationen nicht für internationale Transaktion verifiziert.
19	Name und Postleitzahl stimmen überein.	–	Visa, MasterCard, Discover, American Express	Nur für Acquirer verwendet, die keine Standard-AVS-Rohantwort verwenden.
20	Name, Adresse und Postleitzahl stimmen überein.	–	Visa, MasterCard, Discover, American Express	Nur verwendet für Acquirer, die keine Standard-AVS-Rohantwort verwenden.
21	Namens- und Adressabgleiche.	–	Visa, MasterCard, Discover, American Express	Nur verwendet für Acquirer, die keine Standard-AVS-Rohantwort verwenden.
22	Name stimmt überein.	K	American Express	Name des Kartenmitglieds stimmt überein, aber Rechnungsadresse und Rechnungspostleitzahl stimmen nicht überein.
23	Postleitzahl stimmt überein, Name stimmt nicht überein.	–	Visa, MasterCard, Discover, American Express	Nur für Acquirer verwendet, die keine Standard-AVS-Rohantwort verwenden.
24	Beide Postleitzahlen und Adressen stimmen überein, der Name stimmt nicht überein.	–	Visa, MasterCard, Discover, American Express	Nur für Acquirer verwendet, die keine Standard-AVS-Rohantwort verwenden.
25	Adresse stimmt überein, Name stimmt nicht überein.	–	Visa, MasterCard, Discover, American Express	Nur für Acquirer verwendet, die keine Standard-AVS-Rohantwort verwenden.
26	Weder Postleitzahl, Adresse noch Name passen.	–	Visa, MasterCard, Discover, American Express	Nur für Acquirer verwendet, die keine Standard-AVS-Rohantwort verwenden.