Apple Pay uses the shared wallet options described in Wallets plus a few Apple-only extras.
Example
Availability
Apple Pay renders on Safari (macOS and iOS). On Chromium browsers, the sheet is delivered via a QR handoff to a supported Apple device; control the presentation with renderApplePayCodeAs.
Apple Pay requires HTTPS. It does not render on http:// origins.
Match your surrounding UI:
Use 'plain' when the surrounding CTA already describes the action (“Pay with”). Use 'buy' on ecommerce checkouts.
Chromium QR handoff
On Chromium, tapping the Apple Pay button opens a QR code the shopper scans with a nearby Apple device. Pick where the code renders:
'window' opens a new browser window; 'modal' renders in-page. Modal is generally the better default because it stays inside your checkout container.
supportedNetworks
Restrict the card networks Apple presents inside the sheet:
Omit the option to accept every network your merchant configuration supports.
Recurring payments
Attach a recurring payment request to display subscription copy inside the sheet:
Google Pay does not surface a comparable option; the field is Apple-only.
Requirements escape hatch
Override the derived contact-fields arrays when require does not cover your case:
When requiredBillingContactFields or requiredShippingContactFields is set, it fully replaces the array derived from require.
Shipping methods
Pass shipping methods verbatim under requirements.shippingMethods when you want the shopper to pick a shipping option inside the sheet. Refer to Apple’s platform documentation for the shape.
See also
Last modified on July 17, 2026