Introduction

La vérification d’adresse Le système de vérification d'adresse (AVS) est un contrôle effectué par la banque du consommateur pour sécuriser les paiements à distance réalisés avec des cartes VISA, MASTERCARD et AMERICAN EXPRESS. Ce contrôle est effectif dans les pays anglo-saxons : Royaume-Uni, Australie et USA

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

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

Le fonctionnement

1. Le commerçant transmet l’adresse de facturation du consommateur dans la fonction doWebPayment ou la fonction doAuthorization ;
2. Payline transmet ces informations à l'acquéreur dans la demande d'autorisation de débit ;
3. La banque du consommateur vérifie ces informations avec celles connues sur son client et retourne un résultat qui indique si les informations sont partiellement, totalement ou ne sont pas correctes ;
4. Payline normalise ce résultat et communique en complément le résultat original de l'acquéreur ; 
5. Le commerçant récupère le résultat de l’AVS en réponse du getWebPaymentDetails, doAuthorization ou dans la fonction getTransactionDetails.

une fonction de lutte contre la fraude qui vérifie l'adresse de facturation du titulaire de la carte. 

Le système AVS compare l'adresse de facturation communiquée par le consommateur lors de son achat avec celle enregistrée par sa banque pour l'utilisation de sa carte de paiement. L'AVS n'existe que sur un nombre limité d'acquéreur et de types de cartes et uniquement pour un ensemble limité de pays.

Les acquéreurs compatibles sont : Barclaycard, Worldpay et EMS.

Les cartes éligibles sont : Visa, Mastercard, Américan Express.

L'AVS est actif en Grande Bretagne, en Australie et aux États-Unis.  

Le fonctionnement

Pour utiliser AVS, vous devez fournir l'adresse complète du consommateur à l'aide de l'élément billingAddress de la demande d'autorisation de paiement, comme indiqué ci-dessous: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.

Lorsque vous soumettez l'objet billingAddress, fournissez les éléments suivants :

street1 - renseignez le numéro et nom de rue.

street2 - requis, si disponible.

cityName - non obligatoire.

zipCode -  toujours nécessaire.

country - non obligatoire.

state - non obligatoire.

Vous devez vous assurer d’envoyer dans les éléments Le commerçant doit s’assurer d’envoyer dans les champs street1 et street2 de l’adresse de facturation des les symboles numériques pour les chiffres. Par exemple Exemple : ‘1 "1 rue des Beaumonts’ Beaumonts" et non ‘un "un rue des Beaumonts’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

...

Les codes de réponse AVS sont spécifiques aux réseaux de cartes et aux acquéreurs. Dans le but de simplifier l'utilisation de l'AVS, nous avons mappés ces différents codes de réponse à nos codes de réponse génériques.

Ainsi le résultat de l'AVS est renvoyé dans l’élément avs composé de deux champs :

result - code résultat AVS générique

resultFromAcquirer - code résultat AVS spécifique à chaque acquéreur

L'élément avs est ajouté dans l'objet transaction lorsque la transaction est réalisée sur un contrat où l'AVS est activé. Contactez l'équipe de support Payline pour demander l'activation du contrôle 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>

Les valeurs du code réponse AVS sont les suivantes : 

Vous pouvez tester l'AVS en utilisant les codes postaux suivants :