Address verification system (AVS)

Address verification system (AVS) checks with the acquiring bank if the address of the cardholder matches the billing address. The acquiring bank provides a score as a result of this verification.

Guide

Learn more about AVS

Testing values

The AVS feature is testable in Sandbox when making pay-ins in GBP by changing the two first digits of the billing address PostalCode.

First 2 digits of the PostalCode	AVSResult
22	FULL_MATCH
12, 42, 82	ADDRESS_MATCH_ONLY
21, 24, 28	POSTAL_CODE_MATCH_ONLY
14, 18, 41, 44, 48, 81, 84, 88	NO_MATCH
11, any other value	NO_CHECK

Note – PostalCode default value

Keep in mind that, by default, the Address information of the Billing parameter inherits the values of the Shipping parameter, if provided, otherwise the user (author).

Worked example

Prerequisites

To go through the worked example below, you need to have everything you usually have for making a pay-in:

• A User object, with a GBP wallet
• A GBP card for the same user

REST

{
    "AuthorId": "142036728 ",
    "CreditedWalletId": "150014739",
    "DebitedFunds": {
        "Currency": "GBP",
        "Amount": 5000
    },
    "Fees": {
        "Currency": "GBP",
        "Amount": 100
    },
    "SecureModeReturnURL": "https://docs.mangopay.com/please-ignore",
    "CardId": "162951073",
    "Billing": {
        "FirstName": "Petra",
        "LastName": "Braun",
        "Address": {
            "AddressLine1": "660 Hayes Fork",
            "AddressLine2": "Zora Locks",
            "City": "Paris",
            "Region": "Île-de-France",
            "PostalCode": "22400",
            "Country": "FR"
        }
    },
    "IpAddress": "2001:0620:0000:0000:0211:24FF:FE80:C12C",
    "BrowserInfo": {
        "AcceptHeader": "text/html, application/xhtml+xml, application/xml;q=0.9, /;q=0.8",
        "JavaEnabled": true,
        "Language": "FR-FR",
        "ColorDepth": 4,
        "ScreenHeight": 1800,
        "ScreenWidth": 400,
        "TimeZoneOffset": 60,
        "UserAgent": "Mozilla/5.0 (iPhone; CPU iPhone OS 13_6_1 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Mobile/15E148",
        "JavascriptEnabled": true       
    }
}

API Response with AVS check

{
    "Id": "162996961",
    "Tag": "Created using MANGOPAY API Collection Postman",
    "CreationDate": 1677163753,
    "AuthorId": "142036728",
    "CreditedUserId": "142036728",
    "DebitedFunds": {
        "Currency": "GBP",
        "Amount": 5000
    },
    "CreditedFunds": {
        "Currency": "GBP",
        "Amount": 4900
    },
    "Fees": {
        "Currency": "GBP",
        "Amount": 100
    },
    "Status": "SUCCEEDED",
    "ResultCode": "000000",
    "ResultMessage": "Success",
    "ExecutionDate": 1677163755,
    "Type": "PAYIN",
    "Nature": "REGULAR",
    "CreditedWalletId": "150014739",
    "DebitedWalletId": null,
    "PaymentType": "CARD",
    "ExecutionType": "DIRECT",
    "SecureMode": "DEFAULT",
    "CardId": "162951073",
    "SecureModeReturnURL": "https://docs.mangopay.com/please-ignore?transactionId=162996961",
    "SecureModeRedirectURL": null,
    "SecureModeNeeded": false,
    "Culture": "EN",
    "SecurityInfo": {
        "AVSResult": "FULL_MATCH"
    },
    "StatementDescriptor": "MANGOPAY",
    "BrowserInfo": {
        "AcceptHeader": "text/html, application/xhtml+xml, application/xml;q=0.9, /;q=0.8",
        "JavaEnabled": true,
        "Language": "FR-FR",
        "ColorDepth": 4,
        "ScreenHeight": 1800,
        "ScreenWidth": 400,
        "TimeZoneOffset": 60,
        "UserAgent": "Mozilla/5.0 (iPhone; CPU iPhone OS 13_6_1 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Mobile/15E148",
        "JavascriptEnabled": true
    },
    "IpAddress": "0112:73bb:2d58:2369:2a2e:cf3c:03b4:c6a3",
    "Billing": {
        "FirstName": "Petra",
        "LastName": "Braun",
        "Address": {
            "AddressLine1": "660 Hayes Fork",
            "AddressLine2": "Zora Locks",
            "City": "Paris",
            "Region": "Île-de-France",
            "PostalCode": "22400",
            "Country": "FR"
        }
    },
    "Shipping": {
        "FirstName": "Petra",
        "LastName": "Braun",
        "Address": {
            "AddressLine1": "660 Hayes Fork",
            "AddressLine2": "Zora Locks",
            "City": "Paris",
            "Region": "Île-de-France",
            "PostalCode": "22400",
            "Country": "FR"
        }
    },
    "Requested3DSVersion": null,
    "Applied3DSVersion": "V2_1",
    "RecurringPayinRegistrationId": null
}