<!--
{
  "availability" : [

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

# ApplePayErrorContactField

Names of the fields in the shipping or billing contact information, used to locate errors in the payment sheet.

```
enum ApplePayErrorContactField
```

## Overview

When shipping or billing contact information has an error, you use the error [`code`](/documentation/ApplePayontheWeb/ApplePayError/code) values of either `"shippingContactInvalid"` or `"billingContactInvalid"` to indicate which one has the error. You use the contact field to indicate the exact field with the error. The corresponding field in the shipping or billing section of the payment sheet is highlighted.

Note that the remaining error codes, `"addressUnserviceable"` and `"unknown"`, do not require contact fields.

Use contact field values in the [`contactField`](/documentation/ApplePayontheWeb/ApplePayError/contactField) property of an [`ApplePayError`](/documentation/ApplePayontheWeb/ApplePayError) when you return errors in the completion functions, as shown in the following table.

Contact field values are available in all versions of the API except as stated in the table.

|Contact Field Value                                               |Completion methods that support `"shippingContactInvalid"` error code                                                                                                                                                               |Completion methods that support `"billingContactInvalid"` error code                               |
|------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------|
|`"phoneNumber"`                                                   |``doc://com.apple.applepayontheweb/documentation/ApplePayontheWeb/ApplePaySession/completePayment``                                                                                                                                 |                                                                                                   |
|`"emailAddress"`                                                  |``doc://com.apple.applepayontheweb/documentation/ApplePayontheWeb/ApplePaySession/completePayment``                                                                                                                                 |                                                                                                   |
|`"name"`                                                          |``doc://com.apple.applepayontheweb/documentation/ApplePayontheWeb/ApplePaySession/completePayment``                                                                                                                                 |``doc://com.apple.applepayontheweb/documentation/ApplePayontheWeb/ApplePaySession/completePayment``|
|`"phoneticName"` ![](spacer) (available starting in API version 3)|``doc://com.apple.applepayontheweb/documentation/ApplePayontheWeb/ApplePaySession/completePayment``                                                                                                                                 |``doc://com.apple.applepayontheweb/documentation/ApplePayontheWeb/ApplePaySession/completePayment``|
|`"postalAddress"`                                                 |``doc://com.apple.applepayontheweb/documentation/ApplePayontheWeb/ApplePaySession/completeShippingContactSelection`` ![](spacer) ``doc://com.apple.applepayontheweb/documentation/ApplePayontheWeb/ApplePaySession/completePayment``|``doc://com.apple.applepayontheweb/documentation/ApplePayontheWeb/ApplePaySession/completePayment``|
|`"addressLines"`                                                  |``doc://com.apple.applepayontheweb/documentation/ApplePayontheWeb/ApplePaySession/completePayment``                                                                                                                                 |``doc://com.apple.applepayontheweb/documentation/ApplePayontheWeb/ApplePaySession/completePayment``|
|`"locality"`                                                      |``doc://com.apple.applepayontheweb/documentation/ApplePayontheWeb/ApplePaySession/completeShippingContactSelection`` ![](spacer) ``doc://com.apple.applepayontheweb/documentation/ApplePayontheWeb/ApplePaySession/completePayment``|``doc://com.apple.applepayontheweb/documentation/ApplePayontheWeb/ApplePaySession/completePayment``|
|`"subLocality"`                                                   |``doc://com.apple.applepayontheweb/documentation/ApplePayontheWeb/ApplePaySession/completeShippingContactSelection`` ![](spacer) ``doc://com.apple.applepayontheweb/documentation/ApplePayontheWeb/ApplePaySession/completePayment``|``doc://com.apple.applepayontheweb/documentation/ApplePayontheWeb/ApplePaySession/completePayment``|
|`"postalCode"`                                                    |``doc://com.apple.applepayontheweb/documentation/ApplePayontheWeb/ApplePaySession/completeShippingContactSelection`` ![](spacer) ``doc://com.apple.applepayontheweb/documentation/ApplePayontheWeb/ApplePaySession/completePayment``|``doc://com.apple.applepayontheweb/documentation/ApplePayontheWeb/ApplePaySession/completePayment``|
|`"administrativeArea"`                                            |``doc://com.apple.applepayontheweb/documentation/ApplePayontheWeb/ApplePaySession/completeShippingContactSelection`` ![](spacer) ``doc://com.apple.applepayontheweb/documentation/ApplePayontheWeb/ApplePaySession/completePayment``|``doc://com.apple.applepayontheweb/documentation/ApplePayontheWeb/ApplePaySession/completePayment``|
|`"subAdministrativeArea"`                                         |``doc://com.apple.applepayontheweb/documentation/ApplePayontheWeb/ApplePaySession/completeShippingContactSelection`` ![](spacer) ``doc://com.apple.applepayontheweb/documentation/ApplePayontheWeb/ApplePaySession/completePayment``|``doc://com.apple.applepayontheweb/documentation/ApplePayontheWeb/ApplePaySession/completePayment``|
|`"country"`                                                       |``doc://com.apple.applepayontheweb/documentation/ApplePayontheWeb/ApplePaySession/completeShippingContactSelection`` ![](spacer) ``doc://com.apple.applepayontheweb/documentation/ApplePayontheWeb/ApplePaySession/completePayment``|``doc://com.apple.applepayontheweb/documentation/ApplePayontheWeb/ApplePaySession/completePayment``|
|`"countryCode"`                                                   |``doc://com.apple.applepayontheweb/documentation/ApplePayontheWeb/ApplePaySession/completeShippingContactSelection`` ![](spacer) ``doc://com.apple.applepayontheweb/documentation/ApplePayontheWeb/ApplePaySession/completePayment``|``doc://com.apple.applepayontheweb/documentation/ApplePayontheWeb/ApplePaySession/completePayment``|

---

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)