AddressVerificationData

  • The JSON object represents an address for Address Verification Service (AVS) purposes.

  • It includes fields for address lines, locality (city/town), administrative area (state/province), postal code, and country code.

  • While all fields are optional, providing as much information as possible ensures greater accuracy in address verification.

  • localityName should be omitted for regions with less defined localities like Japan and China, using addressLine instead.

  • For the US, administrativeAreaName should be the 2-letter state abbreviation.

Contains address fields to be verified by AVS.

JSON representation 
{
  "addressLine": [
    string
  ],
  "localityName": string,
  "administrativeAreaName": string,
  "postalCodeNumber": string,
  "countryCode": string
}
Fields
addressLine[]

string

OPTIONAL: This holds unstructured Address text.
localityName

string

OPTIONAL: This is something of a fuzzy term, but it generally refers to the city/town portion of an address. In regions of the world where localities are not well defined or do not fit into this structure well (for example, Japan and China), leave localityName empty and use addressLine.

Examples: US city, IT comune, UK post town.
administrativeAreaName

string

OPTIONAL: The top-level administrative subdivision of this country for the user's billing address.

Examples: US state, IT region, UK constituent nation, JP prefecture

When country == US, this is expected to be the 2-character abbreviation for the US State.
postalCodeNumber

string

OPTIONAL: The user's billing postal code.
countryCode

string

OPTIONAL: The country code of the user's billing address in ISO-3166-1 Alpha-2 format.