Secure context
This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.
The read-only methodDetails
property of the PaymentMethodChangeEvent
interface is an object containing any data the payment handler may provide to describe the change the user has made to their payment method. The value is null
if no details are available.
Syntax
details = paymentMethodChangeEvent.methodName;
Value
An object containing any data needed to describe the changes made to the payment method. The contents vary depending on the actual payment method chosen, so you will need to refer to the methodName
property first, then inerpret the methodDetails
after that.
The default value is null
, indicating that no additional details are available.
Example
This example uses the paymentmethodchange
event to watch for changes to the payment method selected for Apple Pay, in order to compute a discount if the user chooses to use a Visa card as their payment method.
request.onpaymentmethodchange = function(ev) { const { type: cardType } = ev.methodDetails; const newStuff = {}; if (ev.methodName === "https://apple.com/apple-pay") { switch (cardType) { case "visa": // do Apple Pay specific handling for Visa card... // methodDetails contains the card information const result = calculateDiscount(ev.methodDetails); Object.assign(newStuff, result); break; } } // finally... ev.updateWith(newStuff); }; const response = await request.show();
Note that the methodDetails
property is being used by the calculateDiscount()
function to compute any payment discount, then updateWith()
is called to update the event with the computed update.
Specifications
Specification | Status | Comment |
---|---|---|
Payment Request API The definition of 'PaymentMethodChangeEvent.methodDetails' in that specification. |
Candidate Recommendation | Initial definition. |
Browser compatibility
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
methodDetails | Chrome No support No | Edge No support No | Firefox
Full support
63
| IE No support No | Opera No support No | Safari ? | WebView Android No support No | Chrome Android No support No | Firefox Android
Full support
63
| Opera Android No support No | Safari iOS ? | Samsung Internet Android No support No |
Legend
- Full support
- Full support
- No support
- No support
- Compatibility unknown
- Compatibility unknown
- See implementation notes.
- See implementation notes.
- User must explicitly enable this feature.
- User must explicitly enable this feature.