- Directives d'intégration
- Fonctionnalités prises en charge (Sécurité)
- Service de vérification d'adresse
Service de vérification d'adresse
Le service de vérification d’adresse (AVS) est une fonction de sécurité qui sert à comparer l’adresse de facturation saisie par l’acheteur avec les enregistrements détenus par l’émetteur de la carte. Un code de résultat AVS est renvoyé dans le message de réponse de la transaction, indiquant jusqu’à quel point l’adresse correspond (ou ne correspond pas). Il appartient à l’application du commerçant de décider comment gérer la transaction de paiement sur la base du code de résultat AVS. Il est également possible de rejeter une transaction à partir d’une réponse AVS en utilisant le service de gestion des risques. Pour plus d'informations sur la gestion des risques, contactez votre your payment service provider.
Le service AVS n’est pris en charge que par quelques acquéreurs. De plus, toutes les banques ne prennent pas en charge le service AVS, de sorte que même si des données AVS sont transmises dans la demande de transaction, si la banque émettrice ne prend pas en charge le service AVS, elle ne sera pas traitée.
Les champs utilisés pour le nom et l’adresse de facturation de l’acheteur peuvent être utilisés pour envoyer des informations de vérification d’adresse.
Exemple de demande et de réponse
Cette section détaille un exemple de demande et de réponse AVS.
{ "apiOperation": "PAY", "billing": { "address": { "postcodeZip": "CR1 012", "street": "Leamington Street" } }, "order": { "amount": "100.00", "currency": "EUR", "transactionFiltering": { "avsResponseCodeRules": [ { "avsResponseCode": "ADDRESS_MATCH", "action": "NO_ACTION" }, { "avsResponseCode": "ADDRESS_ZIP_MATCH", "action": "NO_ACTION" }, { "avsResponseCode": "NAME_ADDRESS_MATCH", "action": "REVIEW" }, { "avsResponseCode": "NAME_MATCH", "action": "NO_ACTION" }, { "avsResponseCode": "NAME_ZIP_MATCH", "action": "REJECT" }, { "avsResponseCode": "NOT_AVAILABLE", "action": "REVIEW" }, { "avsResponseCode": "NOT_REQUESTED", "action": "NO_ACTION" }, { "avsResponseCode": "NOT_VERIFIED", "action": "REJECT" }, { "avsResponseCode": "NO_MATCH", "action": "REVIEW" }, { "avsResponseCode": "SERVICE_NOT_AVAILABLE_RETRY", "action": "NO_ACTION" }, { "avsResponseCode": "SERVICE_NOT_SUPPORTED", "action": "REJECT" }, { "avsResponseCode": "ZIP_MATCH", "action": "REVIEW" } ] } }, "sourceOfFunds": { "provided": { "card": { "expiry": { "month": "05", "year": "20" }, "number": "<16 digit card number>", "nameOnCard": "TESTNAME" } }, "type": "CARD" } }
{ "gatewayEntryPoint": "WEB_SERVICES_API", "merchant": "AVSCSC_PAY", "billing": { "address": { "postcodeZip": "CR1 012", "street": "Leamington Street" } }, "order": { "amount": 100.00, "authenticationStatus": "AUTHENTICATION_NOT_IN_EFFECT", "chargeback": { "amount": 0, "currency": "EUR" }, "creationTime": "2022-04-28T13:36:22.376Z", "currency": "EUR", "id": "831941870", "lastUpdatedTime": "2022-04-28T13:36:22.758Z", "merchantAmount": 100.00, "merchantCategoryCode": "6879", "merchantCurrency": "EUR", "status": "CAPTURED", "totalAuthorizedAmount": 100.00, "totalCapturedAmount": 100.00, "totalDisbursedAmount": 0.00, "totalRefundedAmount": 0.00, "transactionFiltering": { "avsResponseCodeRules": [ { "action": "NO_ACTION", "avsResponseCode": "ADDRESS_MATCH" }, { "action": "NO_ACTION", "avsResponseCode": "ADDRESS_ZIP_MATCH" }, { "action": "REVIEW", "avsResponseCode": "NAME_ADDRESS_MATCH" }, { "action": "NO_ACTION", "avsResponseCode": "NAME_MATCH" }, { "action": "REJECT", "avsResponseCode": "NAME_ZIP_MATCH" }, { "action": "REVIEW", "avsResponseCode": "NOT_AVAILABLE" }, { "action": "NO_ACTION", "avsResponseCode": "NOT_REQUESTED" }, { "action": "REJECT", "avsResponseCode": "NOT_VERIFIED" }, { "action": "REVIEW", "avsResponseCode": "NO_MATCH" }, { "action": "NO_ACTION", "avsResponseCode": "SERVICE_NOT_AVAILABLE_RETRY" }, { "action": "REJECT", "avsResponseCode": "SERVICE_NOT_SUPPORTED" }, { "action": "REVIEW", "avsResponseCode": "ZIP_MATCH" } ] } }, "response": { "acquirerCode": "0000", "cardSecurityCode": { "acquirerCode": "M", "gatewayCode": "MATCH" }, "cardholderVerification": { "avs": { "acquirerCode": "M", "gatewayCode": "ADDRESS_ZIP_MATCH" } }, "gatewayCode": "APPROVED", "gatewayRecommendation": "NO_ACTION" }, "result": "SUCCESS", "risk": { "response": { "gatewayCode": "ACCEPTED", "review": { "decision": "NOT_REQUIRED" }, "rule": [ { "data": "M", "name": "MERCHANT_AVS", "recommendation": "NO_ACTION", "type": "MERCHANT_RULE" }, { "data": "512345", "name": "MERCHANT_BIN_RANGE", "recommendation": "NO_ACTION", "type": "MERCHANT_RULE" }, { "data": "M", "name": "MERCHANT_CSC", "recommendation": "NO_ACTION", "type": "MERCHANT_RULE" }, { "name": "SUSPECT_CARD_LIST", "recommendation": "NO_ACTION", "type": "MERCHANT_RULE" }, { "name": "TRUSTED_CARD_LIST", "recommendation": "NO_ACTION", "type": "MERCHANT_RULE" }, { "data": "512345", "name": "MSO_BIN_RANGE", "recommendation": "NO_ACTION", "type": "MSO_RULE" }, { "data": "M", "name": "MSO_CSC", "recommendation": "NO_ACTION", "type": "MSO_RULE" } ] } }, "sourceOfFunds": { "provided": { "card": { "brand": "MASTERCARD", "expiry": { "month": "5", "year": "20" }, "fundingMethod": "CREDIT", "number": "512345xxxxxx0008", "scheme": "MASTERCARD", "storedOnFile": "NOT_STORED" } }, "type": "CARD" }, "timeOfLastUpdate": "2022-04-28T13:36:22.758Z", "timeOfRecord": "2022-04-28T13:36:22.606Z", "transaction": { "acquirer": { "batch": 1, "id": "SYSTEST_ACQ1", "merchantId": "123456" }, "amount": 100.00, "authenticationStatus": "AUTHENTICATION_NOT_IN_EFFECT", "authorizationCode": "OK098Z", "currency": "EUR", "id": "85290238", "receipt": "2204284", "source": "INTERNET", "stan": "4", "terminal": "2345678", "type": "PAYMENT" }, "version": "64" }