Introduction

La vérification d’adresse est un contrôle effectué par les serveurs d’autorisation émetteur et/ou les réseaux pour sécuriser les paiements à distance réalisés avec des cartes VISA, MASTERCARD et AMEX. Ces contrôles sont effectifs dans les pays anglo-saxons : Royaume-Uni, Australie et USA

La vérification concerne les champs : le code postal et la ligne adresse (numéro et nom de la rue).

Le résultat de la vérification ne devrait pas impacter pas le résultat d’autorisation rendu par la banque du porteur de la carte (SAE).

• Le serveur d’autorisation acquéreur peut sous certaines conditions refuser une demande d’autorisation avec un contrôle d’adresse en échec.
• La vérification d’adresse est paramétrée au niveau de la banque du commerçant (SAA).

L'AVS s'applique au paiement unitaire, au premier paiement récurrent (pour REC, NX et 1-Clic) et au paiement complémentaire.

La configuration Payline

Le commerçant envoie l'adresse et Payline retourne le résultat de l'AVS.

Le commerçant peut également consulter le résultat dans le détail de la transaction du centre administration Payline.

Le fonctionnement

Les échanges de données :

• Le commerçant valorise l’adresse de facturation dans le doWebPayment ou le doAuthorization avec une version 17 ou supérieure ;
• Le commerçant récupère le résultat de l’AVS en réponse du getWebPaymentDetails, doAuthorization ou getTransactionDetails.

L’AVS prends en compte les champs ‘rue’ et ‘code postal’ de l’adresse de facturation : Street1, Street2, zipCode

<billingAddress>
	<title>M</title>
	<name xsi:nil="true"/>
	<firstName>Prénom</firstName>
	<lastName>Nomdefamille</lastName>
	<street1>260 rue Claude Nicolas Ledoux</street1>
	<street2>Batiment 2</street2>
	<cityName>Aix-en-provence</cityName>
	<zipCode>13100</zipCode>
	<country>FRA</country>
	<phone xsi:nil="true"/>
	<state xsi:nil="true"/>
</billingAddress>

Ces données sont facultatives.

Le commerçant doit s’assurer d’envoyer dans les champs street1 et street2 de l’adresse de facturation des symboles numériques pour les chiffres. Par exemple : ‘1 rue des Beaumonts’ et non ‘un rue des Beaumonts’.

Les résultats de la vérification

Le résultat de la vérification est retourné dans le champ AVS de l'objet transaction. L’objet avs est facultatif.

Ce champ est composé de deux valeurs:

L’objet avs n’est présent que si le serveur d’autorisation acquéreur est configuré pour retourner le résultat de la vérification d’adresse.

Les valeurs du code résultat Payline sont les suivantes : result

Codes retournés par Barclays et Worldpay

Le tableau synthétisant les réponses resultFromAcquirer

• Le premier chiffre correspond à la vérification de l’adresse
• Le deuxième chiffre correspond à la vérification du code postal

Ex : 24 => l’adresse correspond mais le code postal ne correspond pas

Codes retounés par EMS

Le tableau synthétisant les réponses resultFromAcquirer

Valeur	Rue	CP	Libellé	Visa	Mastercard	AMEX
A			Champs ‘rue’ de l’adresse correspondent. Les codes postaux ne correspondent pas.
B			Champs ‘rue’ de l’adresse correspondent. Les codes postaux ne correspondent pas pour cause d’incompatibilité de format.			-
C			Aucuns des champs ‘rue’ et codes postaux ne correspondent pour cause d’incompatibilité de format.			-
D			Correspondance totale des champs ‘rue’ et code postaux pour une transaction internationale.			-
F			Correspondance totale des champs ‘rue’ et code postaux pour une transaction nationale au Royaume Uni.	-		-
G			Contrôle non effectué par le SAE (droits acquéreur non impliqués).			-
I			Contrôle non effectué par le SAE (droits acquéreur impliqués pour usage futur).			-
M			Champs ‘rue’ de l’adresse correspondent (droits acquéreur impliqués pour usage futur).			-
N			Aucuns des champs ‘rue’ et codes postaux ne correspondent.
P			Les codes postaux correspondent. Champs ‘rue’ de l’adresse ne correspondent pas pour cause d’incompatibilité de format.			-
R			Pas de réponse, recommencer l’opération.
S			L’AVS n’est pas disponible.	-
U			Contrôle non effectué (droits acquéreur impliqués).			-
W			Les codes postaux correspondent. Champs ‘rue’ de l’adresse ne correspondent pas (pour les adresses aux USA).	-		-
X			Les codes postaux correspondent. Champs ‘rue’ de l’adresse correspondent (pour les adresses aux USA).	-		-
Y			Correspondance totale des champs ‘rue’ et code postaux pour une transaction nationale
Z			Les codes postaux correspondent

Note : Valeur valide Valeur invalide Pas de contrôle 

Exemple de résultat AVS :

<transaction>
  <obj:id>17194165758191</obj:id>
  <obj:date>13/07/2017 16:57:58</obj:date>
  <obj:isDuplicated>0</obj:isDuplicated>
  <obj:isPossibleFraud>0</obj:isPossibleFraud>
  <obj:fraudResult/>
  <obj:explanation/>
  <obj:threeDSecure>N</obj:threeDSecure>
  <obj:score>0</obj:score>
  <obj:avs>
    <obj:result>0</obj:result>
    <obj:resultFromAcquirer>22</obj:resultresultFromAcquirer> 
  </obj:avs>
</transaction>