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 withrenderApplePayCodeAs.
Apple Pay requires HTTPS. It does not render on http:// origins.
buttonType and buttonStyle
Match your surrounding UI:
'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:
Recurring payments
Attach a recurring payment request to display subscription copy inside the sheet:Requirements escape hatch
Userequire for the common fields (name, email, phone, billing address, shipping address). When you need a field Apple supports that require doesn’t cover — such as phoneticName — pass requirements.requiredBillingContactFields or requirements.requiredShippingContactFields to fully replace the derived contact-fields array. Similarly, pass shipping choices under requirements.shippingMethods. See Apple’s PaymentRequest documentation for the field values.