Page tree


   


Qu'est-ce que l'AVS ?

Le système de vérification d'adresse (AVS) est 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, American Express.
L'AVS est actif en Grande Bretagne, au Canada 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:

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

Version de l'API

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


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 street1 et street2 de l’adresse de facturation les symboles numériques pour les chiffres. Exemple : "1 rue des Beaumonts" et non "un rue des Beaumonts".

Les résultats de la vérification

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 :


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 : 


Code

Description

0

Correspondance totale

1

Correspondance de l’adresse, pas du code postal

2

Correspondance du code postal, pas de l’adresse

3

Aucune correspondance

4

Contrôle non effectué (pas de données, fonction non supportée, problème technique, timeout,…)



Règle LCLF

Vous pouvez utiliser le retour AVS dans une règle LCLF dédiée Address Verification System (AVS).

pour plus d'information, consulter LCLF - Guide pratique des règles LCLF#AVS-AddressVerificationService

Les retours AVS intervenant après la demande d'autorisation, la règle AVS ne permet pas de déclencher une demande d'authentification. Elle ne permet que de refuser une transaction ou de faire une surveillance (Aucune action + alerte). 


Jeux de tests

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

Code postalCode résultat AVS
684000
654001
804002
784003
674004

Pour Barclaycard, vous pouvez utiliser les deux premiers chiffres du code postal :

Code postalCode résultat AVS
220
421
24, 48, 84, 883
11, 12, 14, 18, 21, 41, 814
par défaut4

Pour Amex, vous pouvez utiliser les montants :

MontantCode résultat AVS
 99010
99023
99031
99042
99054
99064
99074
99082
99090
99101
99113
99122
99130
99141
99153

Pour réaliser les tests, veuillez contacter le support pour configurer un serveur d'autorisation de test. 

Contactez le support Monext Online.