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

This is an experimental technology
Check the Browser compatibility table carefully before using this in production.

The updateWith method of the PaymentRequestUpdateEvent interface updates the details of an existing PaymentRequest.




Details 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 'updateWith()' in that specification.
Candidate Recommendation Initial definition.

Browser Compatibility

FeatureChromeEdgeFirefoxInternet ExplorerOperaSafari
Basic support6115561 No No ?
FeatureAndroid webviewChrome for AndroidEdge mobileFirefox for AndroidOpera AndroidiOS SafariSamsung Internet
Basic support No52 ?561 No ?6.0

1. From version 56: this feature is behind the dom.payments.request.enabled preference (needs to be set to true). To change preferences in Firefox, visit about:config.

Document Tags and Contributors

Contributors to this page: marcoscaceres, fscholz, jpmedley, chrisdavidmills
Last updated by: marcoscaceres,