<!--
{
  "documentType" : "article",
  "framework" : "ApplePayontheWeb",
  "identifier" : "/documentation/ApplePayontheWeb/apple-pay-on-the-web-version-3-release-notes",
  "metadataVersion" : "0.1.0",
  "role" : "article",
  "title" : "Apple Pay on the Web Version 3 Release Notes"
}
-->

# Apple Pay on the Web Version 3 Release Notes

The version of Apple Pay available in macOS 10.13 and iOS 11.

## Discussion

New features include:

- New error handling provided using [`ApplePayError`](/documentation/ApplePayontheWeb/ApplePayError).
- To support enhanced error handling, the number and type of arguments were changed for the following completion methods:

|Method                                                                                                              |Argument for Version 3                                                                                |Arguments for Versions 1 and 2                                                                                                                                                       |
|--------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
|``doc://com.apple.applepayontheweb/documentation/ApplePayontheWeb/ApplePaySession/completePaymentMethodSelection``  |``doc://com.apple.applepayontheweb/documentation/ApplePayontheWeb/ApplePayPaymentMethodUpdate``       |<doc://com.apple.applepayontheweb/documentation/ApplePayontheWeb/ApplePaySession/completePaymentMethodSelection#completePaymentMethodSelection-in-Apple-Pay-JS-API-versions-1-and-2> |
|``doc://com.apple.applepayontheweb/documentation/ApplePayontheWeb/ApplePaySession/completeShippingContactSelection``|``doc://com.apple.applepayontheweb/documentation/ApplePayontheWeb/ApplePayShippingContactUpdate``     |<doc://com.apple.applepayontheweb/documentation/ApplePayontheWeb/ApplePaySession/completeShippingContactSelection#completeShippingContactSelection-in-Apple-Pay-JS-version-1-and-2>  |
|``doc://com.apple.applepayontheweb/documentation/ApplePayontheWeb/ApplePaySession/completeShippingMethodSelection`` |``doc://com.apple.applepayontheweb/documentation/ApplePayontheWeb/ApplePayShippingMethodUpdate``      |<doc://com.apple.applepayontheweb/documentation/ApplePayontheWeb/ApplePaySession/completeShippingMethodSelection#completeShippingMethodSelection-in-Apple-Pay-JS-API-version-1-and-2>|
|``doc://com.apple.applepayontheweb/documentation/ApplePayontheWeb/ApplePaySession/completePayment``                 |``doc://com.apple.applepayontheweb/documentation/ApplePayontheWeb/ApplePayPaymentAuthorizationResult``|<doc://com.apple.applepayontheweb/documentation/ApplePayontheWeb/ApplePaySession/completePayment#completePayment-in-Apple-Pay-JS-API-version-1-and-2>                                |

- Support added for phonetic names in contact information, including `phoneticName` in [`ApplePayContactField`](/documentation/ApplePayontheWeb/ApplePayContactField); [`phoneticFamilyName`](/documentation/ApplePayontheWeb/ApplePayPaymentContact/phoneticFamilyName) and [`phoneticGivenName`](/documentation/ApplePayontheWeb/ApplePayPaymentContact/phoneticGivenName) in [`ApplePayPaymentContact`](/documentation/ApplePayontheWeb/ApplePayPaymentContact).
- Added a new property to [`ApplePayPaymentRequest`](/documentation/ApplePayontheWeb/ApplePayPaymentRequest) called [`supportedCountries`](/documentation/ApplePayontheWeb/ApplePayPaymentRequest/supportedCountries) that lets you limit payments to cards from specific countries.

---

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)