PaymentRequestUpdateEvent

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 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 API
The definition of 'PaymentRequestUpdateEvent' in that specification.
Candidate Recommendation Initial definition.

Browser compatibility

Update compatibility data on GitHub
DesktopMobile
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome for AndroidFirefox for AndroidOpera for AndroidSafari on iOSSamsung Internet
PaymentRequestUpdateEventChrome Full support 60Edge Full support 15Firefox 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 NoOpera Full support 47Safari Full support 11.1WebView Android No support NoChrome Android Full support 56Firefox 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 43Safari iOS Full support 11.3Samsung Internet Android Full support 6.0
PaymentRequestUpdateEvent() constructorChrome Full support 60Edge Full support 15Firefox No support No
Notes
No support No
Notes
Notes Available only in nightly builds.
IE No support NoOpera Full support 47Safari Full support 11.1WebView Android No support NoChrome Android Full support 56Firefox Android No support No
Notes
No support No
Notes
Notes Available only in nightly builds.
Opera Android Full support 43Safari iOS Full support 11.3Samsung Internet Android Full support 6.0
updateWith()Chrome Full support 60Edge Full support 15Firefox No support No
Notes
No support No
Notes
Notes Available only in nightly builds.
IE No support NoOpera Full support 47Safari Full support 11.1WebView Android No support NoChrome Android Full support 56Firefox Android No support No
Notes
No support No
Notes
Notes Available only in nightly builds.
Opera Android Full support 43Safari iOS Full support 11.3Samsung Internet Android Full support 6.0

Legend

Full support  
Full support
No support  
No support
See implementation notes.
See implementation notes.

See also