PaymentRequestUpdateEvent

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

See full compatibility

Secure context: This 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: Dispatched whenever the user changes their shipping address.
shippingoptionchange: Dispatched whenever the user changes a shipping option.

Constructor

PaymentRequestUpdateEvent(): Creates a new PaymentRequestUpdateEvent object.

Instance properties

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

Instance methods

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

PaymentRequestUpdateEvent.updateWith(): 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
Payment Request API # paymentrequestupdateevent-interface

Browser compatibility

	desktop					mobile
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox for Android	Opera Android	Safari on iOS	Samsung Internet	WebView Android	WebView on iOS
`PaymentRequestUpdateEvent`	Chrome – Full support Chrome 60 (Release date: 2017-07-25) footnote Full support	Edge – Full support Edge 15 (Release date: 2017-04-05) footnote Full support	Firefox – No support Firefox 55 (Release date: 2017-08-08) disabled disabled From version 55 users must explicitly set the `dom.payments.request.enabled` preference to `true`. To change preferences in Firefox, visit about:config. disabled From version 55 users must explicitly set the `dom.payments.request.supportedRegions` preference to `A comma-delimited list of one or more 2-character ISO country codes indicating the countries in which to support payments (for example, US,CA).`. To change preferences in Firefox, visit about:config.	Opera – Full support Opera 47 (Release date: 2017-08-09) footnote Full support	Safari – Full support Safari 11.1 (Release date: 2018-04-12) footnote Full support	Chrome Android – Full support Chrome Android 53 (Release date: 2016-09-07) footnote Full support	Firefox for Android – No support Firefox for Android footnote No support	Opera Android – Full support Opera Android 41 (Release date: 2016-10-25) footnote Full support	Safari on iOS – Full support Safari on iOS 11.3 (Release date: 2018-03-29) footnote Full support	Samsung Internet – Full support Samsung Internet 6 (Release date: 2017-08-23) footnote Full support	WebView Android – Full support WebView Android 136 (Release date: 2025-04-29) footnote Full support	WebView on iOS – Full support WebView on iOS 11.3 (Release date: 2018-03-29) footnote Full support
`PaymentRequestUpdateEvent()` constructor	Chrome – Full support Chrome 60 (Release date: 2017-07-25) footnote Full support	Edge – Full support Edge 15 (Release date: 2017-04-05) footnote Full support	Firefox – No support Firefox 55 (Release date: 2017-08-08) disabled disabled From version 55 users must explicitly set the `dom.payments.request.enabled` preference to `true`. To change preferences in Firefox, visit about:config.	Opera – Full support Opera 47 (Release date: 2017-08-09) footnote Full support	Safari – Full support Safari 11.1 (Release date: 2018-04-12) footnote Full support	Chrome Android – Full support Chrome Android 53 (Release date: 2016-09-07) footnote Full support	Firefox for Android – No support Firefox for Android footnote No support	Opera Android – Full support Opera Android 41 (Release date: 2016-10-25) footnote Full support	Safari on iOS – Full support Safari on iOS 11.3 (Release date: 2018-03-29) footnote Full support	Samsung Internet – Full support Samsung Internet 6 (Release date: 2017-08-23) footnote Full support	WebView Android – Full support WebView Android 136 (Release date: 2025-04-29) footnote Full support	WebView on iOS – Full support WebView on iOS 11.3 (Release date: 2018-03-29) footnote Full support
Secure context required Experimental	Chrome – Full support Chrome 122 (Release date: 2024-02-20) footnote Full support	Edge – Full support Edge 122 (Release date: 2024-02-23) footnote Full support	Firefox – No support Firefox footnote No support	Opera – Full support Opera 108 (Release date: 2024-03-05) footnote Full support	Safari – No support Safari footnote No support	Chrome Android – Full support Chrome Android 122 (Release date: 2024-02-20) footnote Full support	Firefox for Android – No support Firefox for Android footnote No support	Opera Android – Full support Opera Android 81 (Release date: 2024-03-14) footnote Full support	Safari on iOS – No support Safari on iOS footnote No support	Samsung Internet – Full support Samsung Internet 26 (Release date: 2024-06-07) footnote Full support	WebView Android – Full support WebView Android 136 (Release date: 2025-04-29) footnote Full support	WebView on iOS – No support WebView on iOS footnote No support
`updateWith()`	Chrome – Full support Chrome 60 (Release date: 2017-07-25) footnote Full support	Edge – Full support Edge 15 (Release date: 2017-04-05) footnote Full support	Firefox – No support Firefox 55 (Release date: 2017-08-08) disabled disabled From version 55 users must explicitly set the `dom.payments.request.enabled` preference to `true`. To change preferences in Firefox, visit about:config.	Opera – Full support Opera 47 (Release date: 2017-08-09) footnote Full support	Safari – Full support Safari 11.1 (Release date: 2018-04-12) footnote Full support	Chrome Android – Full support Chrome Android 53 (Release date: 2016-09-07) footnote Full support	Firefox for Android – No support Firefox for Android footnote No support	Opera Android – Full support Opera Android 41 (Release date: 2016-10-25) footnote Full support	Safari on iOS – Full support Safari on iOS 11.3 (Release date: 2018-03-29) footnote Full support	Samsung Internet – Full support Samsung Internet 6 (Release date: 2017-08-23) footnote Full support	WebView Android – Full support WebView Android 136 (Release date: 2025-04-29) footnote Full support	WebView on iOS – Full support WebView on iOS 11.3 (Release date: 2018-03-29) footnote Full support

Tip: you can click/tap on a cell for more information.

Full support: Full support
No support: No support
: Experimental. Expect behavior to change in the future.
: User must explicitly enable this feature.