<!--
{
  "availability" : [

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

# Apple Pay on the Web

Support Apple Pay on your website with JavaScript-based APIs.

## Overview

Safari supports two JavaScript APIs that let you accept Apple Pay payments from customers on your website:

- <doc://com.apple.documentation/documentation/ApplePayontheWeb/payment-request-api>, a [W3C candidate API](https://www.w3.org/TR/payment-request/)
- <doc://com.apple.documentation/documentation/ApplePayontheWeb/apple-pay-js-api>, analogous to the <doc://com.apple.documentation/documentation/PassKit> framework for Apple Pay in apps

> Tip:
> You can try out Apple Pay transactions on the demo page. See [Apple Pay on the Web Interactive Demo](https://applepaydemo.apple.com).

Apple Pay is available on all iOS devices with a Secure Element — an industry-standard, certified chip designed to store payment information safely. In macOS, to authorize the payment, users need a Mac with Touch ID, or an Apple Pay-capable iPhone or Apple Watch..

### Apple Pay availability by region and platform

Apple Pay is available in [supported regions](https://www.apple.com/ios/feature-availability/#apple-pay).

The Apple Pay APIs are available in Safari on the following platforms:

|                       |**Worldwide (except China)**                                                    |**China**                                              |
|-----------------------|--------------------------------------------------------------------------------|-------------------------------------------------------|
|**Apple Pay JS**       |iOS 10 and later ![](spacer) macOS 10.12 and later                              |iOS 11.2 and later ![](spacer) (Not available in macOS)|
|**Payment Request API**|iOS 11.3 and later ![](spacer) macOS 10.12.6 and later, in Safari 11.1 and later|iOS 11.3 and later ![](spacer) (Not available in macOS)|

In iOS, Safari and <doc://com.apple.documentation/documentation/SafariServices/SFSafariViewController> objects support Apple Pay.

See <doc://com.apple.documentation/documentation/ApplePayontheWeb/checking-for-apple-pay-availability> to ensure your implementation only displays the Apple Pay button on supported devices.

> Note:
> Regulations in some regions may require specific configurations in your implementation. For more information, see <doc://com.apple.documentation/documentation/PassKit/complying-with-regional-regulations>.

### Apple Pay requirements

To use Apple Pay on your website, the requirements are:

- A website that complies with the Apple Pay guidelines. For more information, see [Acceptable Use Guidelines for Apple Pay on the Web](https://developer.apple.com/apple-pay/acceptable-use-guidelines-for-websites/).
- An Apple Developer account and complete the registration. For more information, see <doc://com.apple.documentation/documentation/ApplePayontheWeb/configuring-your-environment>.
- Serve all pages that include Apple Pay over HTTPS. For more information, see <doc://com.apple.documentation/documentation/ApplePayontheWeb/setting-up-your-server>.

For design guidance, see [Human Interface Guidelines > Apple Pay](https://developer.apple.com/design/human-interface-guidelines/apple-pay/overview/introduction/).

## Topics

### Essentials

[Loading the latest version of the Apple Pay JS SDK](/documentation/ApplePayontheWeb/loading-the-latest-version-of-apple-pay-js)

Link to the most recent autoupdating version of the Apple Pay JS SDK or a version of your choice.

### Apple Pay setup

[Setting Up Your Server](/documentation/ApplePayontheWeb/setting-up-your-server)

Set up your server for secure communications with Apple Pay.

[Configuring Your Environment](/documentation/ApplePayontheWeb/configuring-your-environment)

Create your Apple Pay merchant ID and certificates, and verify your domain.

[Maintaining Your Environment](/documentation/ApplePayontheWeb/maintaining-your-environment)

Prevent interruptions in your Apple Pay service by keeping certificates and domain verification current.

### Apple Pay Later visual merchandising widget

[Adding an Apple Pay Later visual merchandising widget](/documentation/ApplePayontheWeb/adding-an-apple-pay-later-visual-merchandising-widget)

Configure and style Apple Pay Later visual merchandising widgets to match your website.

### Apple order tracking button

[Adding a Track with Apple Wallet button](/documentation/ApplePayontheWeb/adding-a-track-with-apple-wallet-button)

Configure and style an Apple Wallet Button to match your website.

### Apple Pay buttons

[Displaying Apple Pay Buttons Using JavaScript](/documentation/ApplePayontheWeb/displaying-apple-pay-buttons-using-javascript)

Load and configure the JavaScript Apple Pay button.

[`ApplePayButton`](/documentation/ApplePayontheWeb/ApplePayButton)

An object that displays a button either to trigger payments through Apple Pay or to prompt the user to set up a card.

[Displaying Apple Pay Buttons Using CSS](/documentation/ApplePayontheWeb/displaying-apple-pay-buttons-using-css)

Use CSS templates to display Apple Pay buttons in Safari.

### Apple Pay JavaScript APIs

[Choosing an API for Implementing Apple Pay on Your Website](/documentation/ApplePayontheWeb/choosing-an-api-for-implementing-apple-pay-on-your-website)

Compare Apple Pay JS and Payment Request API to choose the right implementation for your website.

[Apple Pay on the Web version history](/documentation/ApplePayontheWeb/apple-pay-on-the-web-version-history)

Learn about features in each version of Apple Pay on the Web.

[Apple Pay JS API](/documentation/ApplePayontheWeb/apple-pay-js-api)

Implement Apple Pay on the web using Apple’s JavaScript API.

[Payment Request API](/documentation/ApplePayontheWeb/payment-request-api)

Accept payments on your website with Apple Pay using the Payment Request API.

### Supported payment networks

[Supporting payment networks](/documentation/ApplePayontheWeb/supported-networks)

Learn which payment networks Apple Pay on the Web supports.

### Errors

[`ApplePayError`](/documentation/ApplePayontheWeb/ApplePayError)

A customizable error type that you create to indicate problems with the address or contact information on an Apple Pay sheet.

### Apple Pay JS SDK change log

[Apple Pay JS change log](/documentation/ApplePayontheWeb/apple-pay-js-change-log)

Learn about new features and updates in the Apple Pay JS SDK.



---

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)
