coderef

Payment handlerLimited availability

The payment handler API registers a web application as a payment handler and responds to payment requests in the browser's user interface, rather than redirecting users to a separate site to complete a payment.

Not yet supported in all major browsers — check the table and provide a fallback.

How to use ↓Compare browsers

Browser support

DesktopChrome
1–69Not supported
70+Supportedsince Oct 16, 2018
Current: 155
Edge
12–18Not supported
79+Supportedsince Jan 15, 2020
Current: 154
Firefox
✕Not supportedup to 157
Current: 157
Safari
✕Not supportedup to 27
Current: 27
MobileChrome Android
18–69Not supported
70+Supportedsince Oct 17, 2018
Current: 155
Firefox Android
✕Not supportedup to 157
Current: 157
Safari iOS
✕Not supportedup to 27
Current: 27

How to use

Not supported in Firefox, Safari, Firefox Android, Safari iOS. Use feature detection below and provide a fallback (or a polyfill) for those browsers.

Example

Full syntax and examples are on MDN: CanMakePaymentEvent.

Feature detection

JS · check before using
if ("Permissions" in globalThis && "permission_payment-handler" in Permissions.prototype) {
  // Permissions.permission_payment-handler is available
}

Documentation (MDN)

Specification

Sub-features

Support for each part of the feature (26). The overall table above shows when the whole feature works.

Sub-featureChromeEdgeFirefoxSafariChrome AndroidFirefox AndroidSafari iOS
CanMakePaymentEvent7079✕✕70✕✕
CanMakePaymentEvent.CanMakePaymentEvent7079✕✕70✕✕
CanMakePaymentEvent.respondWith7079✕✕70✕✕
PaymentManager7079✕✕70✕✕
PaymentManager.enableDelegations8080✕✕80✕✕
PaymentManager.secure_context_required122122✕✕122✕✕
PaymentManager.userHint7079✕✕70✕✕
PaymentRequestEvent7079✕✕70✕✕
PaymentRequestEvent.PaymentRequestEvent7079✕✕70✕✕
PaymentRequestEvent.changePaymentMethod7679✕✕76✕✕
PaymentRequestEvent.changeShippingAddress8080✕✕80✕✕
PaymentRequestEvent.changeShippingOption8080✕✕80✕✕
PaymentRequestEvent.methodData7079✕✕70✕✕
PaymentRequestEvent.modifiers7079✕✕70✕✕
PaymentRequestEvent.openWindow7079✕✕70✕✕
PaymentRequestEvent.paymentOptions8080✕✕80✕✕
PaymentRequestEvent.paymentRequestId7079✕✕70✕✕
PaymentRequestEvent.paymentRequestOrigin7079✕✕70✕✕
PaymentRequestEvent.respondWith7079✕✕70✕✕
PaymentRequestEvent.shippingOptions8080✕✕80✕✕
Show 6 more
Sub-featureChromeEdgeFirefoxSafariChrome AndroidFirefox AndroidSafari iOS
PaymentRequestEvent.topOrigin7079✕✕70✕✕
PaymentRequestEvent.total7079✕✕70✕✕
Permissions.permission_payment-handler6679✕✕66✕✕
ServiceWorkerGlobalScope.canmakepayment_event7079✕✕70✕✕
ServiceWorkerGlobalScope.paymentrequest_event7079✕✕70✕✕
ServiceWorkerRegistration.paymentManager7079✕✕70✕✕