Integration Types
Altre funzionalità
Card Payments
Mobile Wallets
Alternative Payment Methods
Resources
Il Servizio di Verifica dell'Indirizzo (AVS, Address Verification Service) è una funzionalità di sicurezza utilizzata per confrontare l'indirizzo di fatturazione immesso dal pagante con i record conservati dall'issuer della carta. Un codice risultato AVS viene restituito nel messaggio di risposta della transazione per indicare il livello di corrispondenza degli indirizzi (o la mancata corrispondenza). L'applicazione dell'esercente ha il compito di stabilire in che modo gestire la transazione di pagamento in base al codice risultato AVS. È anche possibile rifiutare una transazione in base alla risposta AVS utilizzando il servizio di gestione del rischio. Per ulteriori informazioni sulla gestione del rischio, contattare il provider di servizi di pagamento.
AVS è supportato solo con alcuni acquirer. Inoltre, non tutte le banche supportano AVS, pertanto anche se i dati AVS vengono inviati nella richiesta di transazione, se la banca emittente non supporta questo servizio, i dati non verranno elaborati.
I campi usati per il nome e l'indirizzo di fatturazione del pagante possono essere usati per inviare informazioni sulla verifica degli indirizzi.
Questa sezione descrive in dettaglio una richiesta e una risposta AVS di esempio.
{ "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" }