Introduction

La 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.


Vous devez utiliser la version 17 ou supérieure de l'API Payline pour utiliser la fonction AVS.

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



Les codes retournés par les partenaires : voir le Voir Le tableau synthétisant les réponses resultFromAcquirer

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>