MDN’s new design is in Beta! A sneak peek:


This feature is non-standard and is not on a standards track. Do not use it on production sites facing the Web: it will not work for every user. There may also be large incompatibilities between implementations and the behavior may change in the future.

The PaymentRequestUpdateEvent constructor creates a new PaymentRequestUpdateEvent object which enables a web page to update the details of a PaymentRequest in response to a user action.


var paymentRequestUpdateEvent = new PaymentRequestUpdateEvent(type[, options])


Must be "paymentrequest".
options Optional
Options are as follows:
  • displayItems[]: An array of optional line items for the payment request that the user agent may display, such as product details, tax, and shipping.
  • error: A message to display to the user when an invalid shipping options is passed to PaymentRequestUpdateEvent.updateWith().
  • modifiers: Modifiers for specific payment methods; for example, adjusting the total amount based on the payment method.
  • shippingOptions: The shipping options the user may choose from. If this sequence is blank, it indicates the merchant cannot ship to the current shipping address. The default shipping option may be indicated in this sequence.
  • total: The total amount of the payment request.


Specification Status Comment
Payment Request API
The definition of 'PaymentRequestUpdateEvent' in that specification.
Working Draft Initial definition.

Browser Compatibility

Feature Chrome Firefox (Gecko) Internet Explorer Opera Safari (WebKit)
Basic support No support ? ? No support ?
Feature Android Webview Chrome for Android Firefox Mobile (Gecko) Firefox OS IE Mobile Opera Mobile Safari Mobile
Basic support No support 52 ? ? ? No support ?

Document Tags and Contributors

 Contributors to this page: jpmedley
 Last updated by: jpmedley,