Type Method

paymentShippingAddressInvalidError(withKey:localizedDescription:)

Creates a shipping address error with the supplied key and user-facing error message.

Declaration

class func paymentShippingAddressInvalidError(withKey postalAddressKey: String, localizedDescription: String?) -> Error

Parameters

postalAddressKey

A key value from CNPostalAddress that indicates which part of the address has an error.

localizedDescription

Optional. Provide a localized, user-facing error message string to help the user resolve the error.

Discussion

You can use this convenience method to create a payment error object instead of creating an NSError object yourself. This convenience method indicates an error in the shipping address received from an Apple Pay sheet.

The error you provide and its optional message appear on the Apple Pay sheet. The available space to display messages is limited, so you should keep your messages concise.

For example, Listing 1 shows how to create errors for indicating problems with the zip code and street, using the keys CNPostalAddressPostalCodeKey and CNPostalAddressStreetKey.

Listing 1

Creating custom errors

// Create errors for the zip code and street address
let shippingInvalidZip = PKPaymentRequest.paymentShippingAddressInvalidError(withKey: CNPostalAddressPostalCodeKey,localizedDescription: "Invalid ZIP code")
        let shippingInvalidStreet = PKPaymentRequest.paymentShippingAddressInvalidError(withKey: CNPostalAddressStreetKey,localizedDescription: "Missing street name")
// The result contains both errors       let result = PKPaymentAuthorizationResult(status: .failure, errors: [shippingInvalidZip, shippingInvalidStreet])

See Also

Providing Error Information

class func paymentBillingAddressInvalidError(withKey: String, localizedDescription: String?) -> Error

Creates a billing address error with the supplied key and user-facing error message.

class func paymentContactInvalidError(withContactField: PKContactField, localizedDescription: String?) -> Error

Creates a contact error with the supplied field and user-facing error message.

class func paymentShippingAddressUnserviceableError(withLocalizedDescription: String?) -> Error

Creates an error for an unserviceable address, with the supplied user-facing error message.