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
PaymentMethodChangeEventobject, optionally initialized with values taken from a givenPaymentMethodChangeEventInitdictionary.
Properties
In addition to the properties below, this interface includes properties inherited from PaymentRequestUpdateEvent.
-
methodDetailsRead 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. -
methodNameRead only Secure context -
A
DOMStringcontaining 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 asbasic-card. The default value is the empty string,"".
Methods
This interface includes methods inherited from PaymentRequestUpdateEvent.
Specifications
| Specification |
|---|
| Payment Request API # paymentmethodchangeevent-interface |
Browser compatibility
| Desktop | Mobile | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Internet Explorer | Opera | Safari | WebView Android | Chrome Android | Firefox for Android | Opera Android | Safari on IOS | Samsung Internet | |
PaymentMethodChangeEvent |
76 |
79 |
No
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. |
No |
63 |
12.1 |
No |
76 |
No
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. |
54 |
12.2 |
Yes |
PaymentMethodChangeEvent |
76 |
79 |
No |
No |
63 |
12.1 |
No |
76 |
No |
54 |
12.2 |
Yes |
methodDetails |
76 |
79 |
No |
No |
63 |
12.1 |
No |
76 |
No |
54 |
12.2 |
Yes |
methodName |
76 |
79 |
No |
No |
63 |
12.1 |
No |
76 |
No |
54 |
12.2 |
Yes |
© 2005–2021 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/PaymentMethodChangeEvent