Apple Pay on the web (ApplePaySession)
Pays with Apple Pay in Safari or via the Payment Request API.
In one line
Can start an Apple Pay payment that you confirm with Face ID or Touch ID
Pays with Apple Pay in Safari or via the Payment Request API.
The site gets a payment token, billing and shipping contact only after Face ID or Touch ID approval.
What it can and can't do
What the user does: You tap the Apple Pay button at checkout.
It can
- Show the Apple Pay sheet with your cards and shipping address
- Send a one time payment code to the store after you approve
- Ask for your name, email or phone if you choose to share them
It cannot
- See your real card number
- Charge you without Face ID, Touch ID or your passcode
- Use Apple Pay in Chrome, Edge or Firefox
- Keep your details for later; each payment needs a new approval
How it differs between platforms: Safari on iPhone and Mac supports it directly. Chrome, Edge and Firefox use other wallets.
Browser support
| Browser | Status | First version | Released | Note |
|---|---|---|---|---|
| Chrome | Not supported | Not available | Not listed | None |
| Edge | Not supported | Not available | Not listed | None |
| Firefox | Not supported | Not available | Not listed | None |
| Safari | Supported | 10 | 2016-09-20 | None |
| Safari on iPhone | Supported | 10 | 2016-09-13 | None |
| Chrome on Android | Not supported | Not available | Not listed | None |
| Samsung Internet | Not supported | Not available | Not listed | None |
How a site asks for it
| API | new ApplePaySession(version,request).begin(), onvalidatemerchant, onpaymentauthorized |
| How access is granted | prompt |
| What the user sees | Apple Pay sheet with Face ID, Touch ID or passcode |
| Needs a secure context (HTTPS) | Yes |
| Needs a user gesture | Yes |
| How long it lasts | Per origin |
| How to take it back | Site settings |
| Inside an iframe | Same as top level; cross-origin iframes need a permissions policy where listed |
Typical flow
- Call the API
- Browser applies its access rules
- Page receives the result
Data you get
What comes back: Pays with Apple Pay in Safari or via the Payment Request API.
Shape: object
How often: on demand
| Field | Type | Unit | Range | Precision |
|---|---|---|---|---|
token | object | None | encrypted payment data | processed by the PSP |
shippingContact / billingContact | object | None | name, address, email, phone | if requested |
Technical limits
- Apple devices only
- Needs merchant validation and a registered domain
The story
What it is
Pay in Safari with Apple Pay, confirmed by Face ID or Touch ID.
For you
You tap the Apple Pay button, check the total, and approve with your face or finger. The shop gets a payment token, not your card number.
For makers
Makers get higher checkout completion and fewer card number worries. It also gives them your shipping contact once you approve.
Where you see it
| Type | Example | Apps |
|---|---|---|
| shopping | You pay for shoes on a store site with one tap and no typing. | Nike, Etsy |
| travel | A booking site lets you pay for a flight with Face ID. | Airbnb |
| delivery | A food order site finishes checkout in one tap. | DoorDash, Uber Eats |
| payments | A ticket seller confirms your purchase and sends the tickets to your phone. | Ticketmaster |
| security | A fraud team sees the Apple Pay token and trusts it more than a typed card number. | None named |
| media | A news site sells a subscription with one tap. | The New York Times |
Risks
- Easy overspending
- Only Apple devices
What the platform says
- Apple: Apple Pay on the Web. Apple says Apple Pay lets customers check out quickly and securely on websites in Safari.
Good uses and abuse
Legitimate uses
- Checkout
Known abuse
- None notable
Scores
| Score | Value | Meaning |
|---|---|---|
| Sensitivity | 5 of 5 | How revealing the data is |
| Utility | 4 of 5 | How useful it is to honest apps |
| Friction | 2 of 5 | How much the user has to do |
| Fingerprint bits | Not rated | Rough identifying entropy, when known |
History
- 2016-09, Safari 10: Apple Pay JS ships
- 2017-09, Safari 11.1: Payment Request integration
Sources
How well checked: Based on official documentation.