> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.mangopay.com/testing/mocks/avs/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.mangopay.com/_mcp/server.

# 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](/guides/payment-methods/card/avs)

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

<table>
  <thead>
    <tr>
      <th class="header">
        First 2 digits of the PostalCode
      </th>

      <th class="header">
        AVSResult
      </th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td class="table-content">
        22
      </td>

      <td class="table-content">
        FULL_MATCH
      </td>
    </tr>

    <tr>
      <td class="table-content">
        12, 42, 82
      </td>

      <td class="table-content">
        ADDRESS_MATCH_ONLY
      </td>
    </tr>

    <tr>
      <td class="table-content">
        21, 24, 28
      </td>

      <td class="table-content">
        POSTAL_CODE_MATCH_ONLY
      </td>
    </tr>

    <tr>
      <td class="table-content">
        14, 18, 41, 44, 48, 81, 84, 88
      </td>

      <td class="table-content">
        NO_MATCH
      </td>
    </tr>

    <tr>
      <td class="table-content">
        11, any other value
      </td>

      <td class="table-content">
        NO_CHECK
      </td>
    </tr>
  </tbody>
</table>

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

> **Info**
>
> **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`**

```json REST
{
    "AuthorId": "142036728 ",
    "CreditedWalletId": "150014739",
    "DebitedFunds": {
        "Currency": "GBP",
        "Amount": 5000
    },
    "Fees": {
        "Currency": "GBP",
        "Amount": 100
    },
    "SecureModeReturnURL": "http://example.com",
    "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`**

```json 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": "http://example.com?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
}
```