Web/API/PaymentRequestUpdateEvent

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

The PaymentRequestUpdateEvent interface is used for events sent to a PaymentRequest instance when changes are made to shipping-related information for a pending PaymentRequest. Those events are:

shippingaddresschange Secure context: Dispatched whenever the user changes their shipping address. Also available using the onshippingaddresschange event handler property.
shippingoptionchange Secure context: Dispatched whenever the user changes a shipping option. Also available using the onshippingoptionchange event handler property.

Constructor

PaymentRequestUpdateEvent() Secure context: Creates a new PaymentRequestUpdateEvent object.

Properties

Provides only the properties inherited from its parent interface, Event.

Methods

In addition to methods inherited from the parent interface, Event, PaymentRequestUpdateEvent offers the following methods:

PaymentRequestUpdateEvent.updateWith() Secure context: If the event handler determines that information included in the payment request needs to be changed, or that new information needs to be added, it calls updateWith() with the information that needs to be replaced or added.

Specifications

Specification	Status	Comment
Payment Request APIThe definition of 'PaymentRequestUpdateEvent' in that specification.	Candidate Recommendation	Initial definition.

Browser compatibility

Update compatibility data on GitHub

	Desktop						Mobile
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	Android webview	Chrome for Android	Firefox for Android	Opera for Android	Safari on iOS	Samsung Internet
`PaymentRequestUpdateEvent`	Chrome Full support 60	Edge Full support 15	Firefox 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 No	Opera Full support 47	Safari Full support 11.1	WebView Android No support No	Chrome Android Full support 56	Firefox 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 43	Safari iOS Full support 11.3	Samsung Internet Android Full support 6.0
`PaymentRequestUpdateEvent()` constructor	Chrome Full support 60	Edge Full support 15	Firefox No support No Notes' No support No Notes' Notes' Available only in nightly builds.	IE No support No	Opera Full support 47	Safari Full support 11.1	WebView Android No support No	Chrome Android Full support 56	Firefox Android No support No Notes' No support No Notes' Notes' Available only in nightly builds.	Opera Android Full support 43	Safari iOS Full support 11.3	Samsung Internet Android Full support 6.0
`updateWith()`	Chrome Full support 60	Edge Full support 15	Firefox No support No Notes' No support No Notes' Notes' Available only in nightly builds.	IE No support No	Opera Full support 47	Safari Full support 11.1	WebView Android No support No	Chrome Android Full support 56	Firefox Android No support No Notes' No support No Notes' Notes' Available only in nightly builds.	Opera Android Full support 43	Safari iOS Full support 11.3	Samsung Internet Android Full support 6.0

Legend

Full support: Full support
No support: No support
See implementation notes.': See implementation notes.