Service de vérification d'adresse AVS

S’abonner

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, Américan 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 :

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 : 


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,…)


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

Code postalCode résultat AVS
684000
654001
804002
784003
674004
Vous avez d’autres questions ? Envoyer une demande

Commentaires

Réalisé par Zendesk