← Back to release summary

PaymentRequestEvent.changePaymentMethod()

Category

Miscellaneous

Type

New or changed feature

Status

Enabled by default (Chrome 76)

Intent stage

Start prototyping

• Breaking change: No
• Enterprise impact: None
• Spec maturity: Incubation
• Web Platform Tests: No

WPT details: WPTs are being landed in the same patches as the implementation.

Summary

Enables payment handlers to get the updated total from the merchant in response to a change in payment instrument selected within the payment handler. This fires the PaymentMethodChangeEvent on the merchant website.

Motivation

For example, if the user selects a debit card with a billing address in France, the merchant may need to add value added tax to the total.

Standards & signals

• Specification: https://w3c.github.io/payment-handler/#changepaymentmethod-method
• Firefox: No signal
• Safari: No signal
• Web developers: Positive
• Tracking bug: https://crbug.com/884680

Ecosystem

• Web Platform Tests: https://wpt.fyi/results/?q=paymentrequestevent-changepaymentmethod
• Chrome Platform Showcase: https://chrome-platform-showcase.paulkinlan-ea.deno.net/features
• GenDN reference: https://gendn.paulkinlan-ea.deno.net/features
• chrome.dev demos search: https://www.google.com/search?q=site%3Achrome.dev+PaymentRequestEvent.changePaymentMethod()
• MDN Web Docs: https://developer.mozilla.org/en-US/search?q=PaymentRequestEvent.changePaymentMethod()
• Baseline status: https://webstatus.dev/?q=PaymentRequestEvent.changePaymentMethod()

Docs: https://github.com/w3c/payment-handler/issues/314

Samples: https://rsolomakhin.github.io/pr/apps/pmc/

Explainers: https://github.com/w3c/payment-handler/issues/314

View on chromestatus.com