PaymentItem

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

Browser compatibility

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.

Properties

Specifications

Browser compatibility

Legend

See also

Learn the best of web development