<!--
{
  "availability" : [

  ],
  "documentType" : "symbol",
  "framework" : "ApplePayontheWeb",
  "identifier" : "/documentation/ApplePayontheWeb/ApplePayPaymentContact",
  "metadataVersion" : "0.1.0",
  "role" : "Structure",
  "symbol" : {
    "kind" : "Structure",
    "modules" : [
      "Apple Pay on the Web"
    ],
    "preciseIdentifier" : "struct/ApplePayPaymentContact"
  },
  "title" : "ApplePayPaymentContact"
}
-->

# ApplePayPaymentContact

Contact information fields to use for billing and shipping contact information.

```
dictionary ApplePayPaymentContact {
	DOMString phoneNumber;
	DOMString emailAddress;
	DOMString givenName;
	DOMString familyName;
	DOMString phoneticGivenName;
	DOMString phoneticFamilyName;
	sequence <DOMString> addressLines;
	DOMString subLocality;
	DOMString locality;
	DOMString postalCode;
	DOMString subAdministrativeArea;
	DOMString administrativeArea;
	DOMString country;
	DOMString countryCode;
};
```

## Overview

The [`phoneticGivenName`](/documentation/ApplePayontheWeb/ApplePayPaymentContact/phoneticGivenName) and [`phoneticFamilyName`](/documentation/ApplePayontheWeb/ApplePayPaymentContact/phoneticFamilyName) fields are available starting in Apple Pay version 3.

## Topics

### Contact properties

[`phoneNumber`](/documentation/ApplePayontheWeb/ApplePayPaymentContact/phoneNumber)

A phone number for the contact.

[`emailAddress`](/documentation/ApplePayontheWeb/ApplePayPaymentContact/emailAddress)

An email address for the contact.

[`givenName`](/documentation/ApplePayontheWeb/ApplePayPaymentContact/givenName)

The contact’s given name.

[`familyName`](/documentation/ApplePayontheWeb/ApplePayPaymentContact/familyName)

The contact’s family name.

[`phoneticGivenName`](/documentation/ApplePayontheWeb/ApplePayPaymentContact/phoneticGivenName)

The phonetic spelling of the contact’s given name.

[`phoneticFamilyName`](/documentation/ApplePayontheWeb/ApplePayPaymentContact/phoneticFamilyName)

The phonetic spelling of the contact’s family name.

### Address properties

[`addressLines`](/documentation/ApplePayontheWeb/ApplePayPaymentContact/addressLines)

The street portion of the address for the contact.

[`subLocality`](/documentation/ApplePayontheWeb/ApplePayPaymentContact/subLocality)

Additional information associated with the location, typically defined at the city or town level (such as district or neighborhood), in a postal address.

[`locality`](/documentation/ApplePayontheWeb/ApplePayPaymentContact/locality)

The city for the contact.

[`postalCode`](/documentation/ApplePayontheWeb/ApplePayPaymentContact/postalCode)

The zip code or postal code, where applicable, for the contact.

[`subAdministrativeArea`](/documentation/ApplePayontheWeb/ApplePayPaymentContact/subAdministrativeArea)

The subadministrative area (such as a county or other region) in a postal address.

[`administrativeArea`](/documentation/ApplePayontheWeb/ApplePayPaymentContact/administrativeArea)

The state for the contact.

[`country`](/documentation/ApplePayontheWeb/ApplePayPaymentContact/country)

The name of the country or region for the contact.

[`countryCode`](/documentation/ApplePayontheWeb/ApplePayPaymentContact/countryCode)

The contact’s two-letter ISO 3166 country code.



---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)