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.

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 PostalCodeAVSResult
22FULL_MATCH
12, 42, 82ADDRESS_MATCH_ONLY
21, 24, 28POSTAL_CODE_MATCH_ONLY
14, 18, 41, 44, 48, 81, 84, 88NO_MATCH
11, any other valueNO_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": "Ile-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": "Ile-de-France",
            "PostalCode": "22400",
            "Country": "FR"
        }
    },
    "Shipping": {
        "FirstName": "Petra",
        "LastName": "Braun",
        "Address": {
            "AddressLine1": "660 Hayes Fork",
            "AddressLine2": "Zora Locks",
            "City": "Paris",
            "Region": "Ile-de-France",
            "PostalCode": "22400",
            "Country": "FR"
        }
    },
    "Requested3DSVersion": null,
    "Applied3DSVersion": "V2_1",
    "RecurringPayinRegistrationId": null
}