Skip to main content
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.

buttonType and buttonStyle

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