Web/API/PaymentItem

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

The PaymentItem dictionary is used by the Payment Request API to describe a single line item on a payment request. This might be an item or service being purchased or a tax or other charge.

Properties

amount Secure context

A PaymentCurrencyAmount object describing the monetary value of the item.

label Secure context

A string specifying a human-readable name or description of the item or service being charged for. This may be displayed to the user by the user agent, depending on the design of the interface.

pending Secure context

A Boolean value which is true if the specified amount has not yet been finalized. This can be used to show items such as shipping or tax amounts that depend upon the selection of shipping address, shipping option, or so forth. The user agent may show this information but is not required to do so.

Specifications

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

Browser compatibility

The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.

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
PaymentItem Experimental'	Chrome Full support 61 Disabled' Full support 61 Disabled' Disabled' From version 61: this feature is behind the #web-payments preference (needs to be set to Enabled). To change preferences in Chrome, visit chrome://flags.	Edge Full support ≤18	Firefox Full support 55 Notes' Disabled' Full support 55 Notes' Disabled' Notes' Available only in nightly builds. Disabled' From version 55: this feature is behind the dom.payments.request.enabled preference (needs to be set to true) and the dom.payments.request.supportedRegions preference (needs to be set to A comma-delineated 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.	IE No support No	Opera No support No	Safari ?	WebView Android No support No	Chrome Android Full support 53 Disabled' Full support 53 Disabled' Disabled' From version 53: this feature is behind the #web-payments preference (needs to be set to Enabled). To change preferences in Chrome, visit chrome://flags.	Firefox Android Full support 55 Notes' Disabled' Full support 55 Notes' Disabled' Notes' Available only in nightly builds. Disabled' From version 55: this feature is behind the dom.payments.request.enabled preference (needs to be set to true) and the dom.payments.request.supportedRegions preference (needs to be set to A comma-delineated 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 Android No support No	Safari iOS ?	Samsung Internet Android No support No
amount Experimental'	Chrome Full support 61 Disabled' Full support 61 Disabled' Disabled' From version 61: this feature is behind the #web-payments preference (needs to be set to Enabled). To change preferences in Chrome, visit chrome://flags.	Edge Full support ≤18	Firefox Full support 55 Disabled' Full support 55 Disabled' Disabled' From version 55: this feature is behind the dom.payments.request.enabled preference (needs to be set to true). To change preferences in Firefox, visit about:config.	IE No support No	Opera No support No	Safari ?	WebView Android No support No	Chrome Android Full support 53 Disabled' Full support 53 Disabled' Disabled' From version 53: this feature is behind the #web-payments preference (needs to be set to Enabled). To change preferences in Chrome, visit chrome://flags.	Firefox Android Full support 55 Disabled' Full support 55 Disabled' Disabled' From version 55: this feature is behind the dom.payments.request.enabled preference (needs to be set to true). To change preferences in Firefox, visit about:config.	Opera Android No support No	Safari iOS ?	Samsung Internet Android No support No
label Experimental'	Chrome Full support 61 Disabled' Full support 61 Disabled' Disabled' From version 61: this feature is behind the #web-payments preference (needs to be set to Enabled). To change preferences in Chrome, visit chrome://flags.	Edge Full support ≤18	Firefox Full support 55 Disabled' Full support 55 Disabled' Disabled' From version 55: this feature is behind the dom.payments.request.enabled preference (needs to be set to true). To change preferences in Firefox, visit about:config.	IE No support No	Opera No support No	Safari ?	WebView Android No support No	Chrome Android Full support 53 Disabled' Full support 53 Disabled' Disabled' From version 53: this feature is behind the #web-payments preference (needs to be set to Enabled). To change preferences in Chrome, visit chrome://flags.	Firefox Android Full support 55 Disabled' Full support 55 Disabled' Disabled' From version 55: this feature is behind the dom.payments.request.enabled preference (needs to be set to true). To change preferences in Firefox, visit about:config.	Opera Android No support No	Safari iOS ?	Samsung Internet Android No support No
pending Experimental'	Chrome Full support 61 Disabled' Full support 61 Disabled' Disabled' From version 61: this feature is behind the #web-payments preference (needs to be set to Enabled). To change preferences in Chrome, visit chrome://flags.	Edge Full support ≤18	Firefox Full support 55 Disabled' Full support 55 Disabled' Disabled' From version 55: this feature is behind the dom.payments.request.enabled preference (needs to be set to true). To change preferences in Firefox, visit about:config.	IE No support No	Opera No support No	Safari ?	WebView Android No support No	Chrome Android Full support 53 Disabled' Full support 53 Disabled' Disabled' From version 53: this feature is behind the #web-payments preference (needs to be set to Enabled). To change preferences in Chrome, visit chrome://flags.	Firefox Android Full support 55 Disabled' Full support 55 Disabled' Disabled' From version 55: this feature is behind the dom.payments.request.enabled preference (needs to be set to true). To change preferences in Firefox, visit about:config.	Opera Android No support No	Safari iOS ?	Samsung Internet Android No support No

Legend

Full support  

Full support

No support  

No support

Compatibility unknown  

Compatibility unknown

Experimental. Expect behavior to change in the future.'

Experimental. Expect behavior to change in the future.

See implementation notes.'

See implementation notes.

User must explicitly enable this feature.'

User must explicitly enable this feature.

See also

• Payment Request API
• Using the Payment Request API

PaymentItem by Mozilla Contributors is licensed under CC-BY-SA 2.5.