> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mangopay.com/llms.txt
> Use this file to discover all available pages before exploring further.

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

<CardGroup>
  <Card title="Guide" href="/guides/payment-methods/card/avs">
    Learn more about AVS
  </Card>
</CardGroup>

## 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).
</Note>

## 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
</Info>

```json REST theme={null}
{
    "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       
    }
}
```

```json API Response with AVS check theme={null}
{
    "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
}
```