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.

<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

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>