PaymentMethodChangeEvent

Secure context
This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.

The PaymentMethodChangeEvent interface of the Payment Request API describes the paymentmethodchange event which is fired by some payment handlers when the user switches payment instruments (e.g., a user selects a "store" card to make a purchase while using Apple Pay).

Constructor

PaymentMethodChangeEvent()
Creates and returns a new PaymentMethodChangeEvent object, optionally initialized with values taken from a given PaymentMethodChangeEventInit dictionary.

Properties

In addition to the properties below, this interface includes properties inherited from PaymentRequestUpdateEvent.

methodDetails Read only Secure context
An object containing payment method-specific data useful when handling a payment method change. If no such information is available, this value is null.
methodName Read only Secure context
A DOMString containing the payment method identifier, a string which uniquely identifies a particular payment method. This identifier is usually a URL used during the payment process, but may be a standardized non-URL string as well, such as basic-card. The default value is the empty string, "".

Methods

This interface includes methods inherited from PaymentRequestUpdateEvent.

Specifications

Specification Status Comment
Payment Request API
The definition of 'PaymentMethodChangeEvent' in that specification.
Candidate Recommendation Initial definition.

Browser compatibility

Update compatibility data on GitHub
DesktopMobile
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome for AndroidFirefox for AndroidOpera for AndroidSafari on iOSSamsung Internet
PaymentMethodChangeEventChrome Full support 76Edge Full support 79Firefox No support No
Notes
No support No
Notes
Notes Available only in nightly builds. Requires dom.payments.request.enabled to be set to true and the comma-delineated list in dom.payments.request.supportedRegions to contain one or more of the supported 2-character ISO locales, currently US and CA.
IE No support NoOpera Full support 63Safari Full support 12.1WebView Android No support NoChrome Android Full support 76Firefox Android No support No
Notes
No support No
Notes
Notes Available only in nightly builds. Requires dom.payments.request.enabled to be set to true and the comma-delineated list in dom.payments.request.supportedRegions to contain one or more of the supported 2-character ISO locales, currently US and CA.
Opera Android Full support 54Safari iOS Full support 12.2Samsung Internet Android Full support Yes
methodDetailsChrome Full support 76Edge Full support 79Firefox No support NoIE No support NoOpera Full support 63Safari Full support 12.1WebView Android No support NoChrome Android Full support 76Firefox Android No support NoOpera Android Full support 54Safari iOS Full support 12.2Samsung Internet Android Full support Yes
methodNameChrome Full support 76Edge Full support 79Firefox No support NoIE No support NoOpera Full support 63Safari Full support 12.1WebView Android No support NoChrome Android Full support 76Firefox Android No support NoOpera Android Full support 54Safari iOS Full support 12.2Samsung Internet Android Full support Yes

Legend

Full support  
Full support
No support  
No support
See implementation notes.
See implementation notes.