Skip to Content
Platform.Ontology

Apple Pay on the web (ApplePaySession)

Pays with Apple Pay in Safari or via the Payment Request API.

Works without askingPayments and shoppingCheckoutWeb browsersWhile you use it

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

BrowserStatusFirst versionReleasedNote
ChromeNot supportedNot availableNot listedNone
EdgeNot supportedNot availableNot listedNone
FirefoxNot supportedNot availableNot listedNone
SafariSupported102016-09-20None
Safari on iPhoneSupported102016-09-13None
Chrome on AndroidNot supportedNot availableNot listedNone
Samsung InternetNot supportedNot availableNot listedNone

How a site asks for it

APInew ApplePaySession(version,request).begin(), onvalidatemerchant, onpaymentauthorized
How access is grantedprompt
What the user seesApple Pay sheet with Face ID, Touch ID or passcode
Needs a secure context (HTTPS)Yes
Needs a user gestureYes
How long it lastsPer origin
How to take it backSite settings
Inside an iframeSame as top level; cross-origin iframes need a permissions policy where listed

Typical flow

  1. Call the API
  2. Browser applies its access rules
  3. 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

FieldTypeUnitRangePrecision
tokenobjectNoneencrypted payment dataprocessed by the PSP
shippingContact / billingContactobjectNonename, address, email, phoneif 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

TypeExampleApps
shoppingYou pay for shoes on a store site with one tap and no typing.Nike, Etsy
travelA booking site lets you pay for a flight with Face ID.Airbnb
deliveryA food order site finishes checkout in one tap.DoorDash, Uber Eats
paymentsA ticket seller confirms your purchase and sends the tickets to your phone.Ticketmaster
securityA fraud team sees the Apple Pay token and trusts it more than a typed card number.None named
mediaA news site sells a subscription with one tap.The New York Times

Risks

  • Easy overspending
  • Only Apple devices

What the platform says

Good uses and abuse

Legitimate uses

  • Checkout

Known abuse

  • None notable

Scores

ScoreValueMeaning
Sensitivity5 of 5How revealing the data is
Utility4 of 5How useful it is to honest apps
Friction2 of 5How much the user has to do
Fingerprint bitsNot ratedRough 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.

On this page