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 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

}

Was this page helpful?

PayoutsRecurring card payments