Contenu
Introduction
La vérification d’adresse est un contrôle effectué par les serveurs d’autorisation émetteur et/ou les réseaux pour sécuriser les paiements à distance réalisés avec des cartes VISA, MASTERCARD et AMEX. Ces contrôles sont effectifs dans les pays anglo-saxons : Royaume-Uni, Australie et USA
La vérification concerne les champs : le code postal et la ligne adresse (numéro et nom de la rue).
Le résultat de la vérification ne devrait pas impacter pas le résultat d’autorisation rendu par la banque du porteur de la carte (SAE).
- Le serveur d’autorisation acquéreur peut sous certaines conditions refuser une demande d’autorisation avec un contrôle d’adresse en échec.
- La vérification d’adresse est paramétrée au niveau de la banque du commerçant (SAA).
L'AVS s'applique au paiement unitaire, au premier paiement récurrent (pour REC, NX et 1-Clic) et au paiement complémentaire.
La configuration Payline
Le commerçant envoie l'adresse et Payline retourne le résultat de l'AVS.
Le commerçant peut également consulter le résultat dans le détail de la transaction du centre administration Payline.
Le fonctionnement
Les échanges de données :
- Le commerçant valorise l’adresse de facturation dans le doWebPayment ou le doAuthorization ;
- Le commerçant récupère le résultat de l’AVS en réponse du getWebPaymentDetails, doAuthorization ou getTransactionDetails.
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
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
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,…) |
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
Valeur | Description |
---|---|
1 | Contrôle non effectué (fonction non supportée, problème technique, timeout,…) |
2 | Correspondance totale |
4 | Pas de correspondance |
8 | Correspondance partielle |
Codes retounés par EMS
Le tableau synthétisant les réponses resultFromAcquirer
Valeur | Rue | CP | 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>