PaymentCurrencyAmount.value

The PaymentCurrencyAmount property value is a string containing the decimal numeric value of the payment, specified in the currency units indicated by the currency property. The contents of this string must be a valid decimal number; that is, some number of digits between 0 and 9 with up to one optional decimal point. An optional leading minus sign ("-") can be included to indicate a negative value, such as to represent a refund or discount.

Syntax

value = paymentCurrencyAmount.value;

Value

A DOMString indicating the numeric value of the payment. This must be a valid decimal number, with an optional leading minus sign ("-"), then one or more decimal digits 0 through 9, optionally with a decimal point (".") with at least one digit following it to represent fractional units. There must not be any leading or trailing whitespace in the string.

For uniformity and consistency, the value is always given using the period (".") as the decimal character, regardless of the user's locale. You need to convert the value to this format before submitting the payment.

See the example Verifying a properly formatted price below for a simple regular expression that can be used to validate the value string prior to submission.

Examples

Representing prices

This example represents the price of $42.95 in US dollars:

let itemPrice = {
  currency: "USD",
  value: "42.95"
};

This example specifies a price of £7.77:

let shippingCost = {
  currency: "GBP",
  value: "7.77"
}

This example specifies a price of 1000¥:

let price = {
  currency: "JPY",
  value: "1000"
}

Verifying a properly formatted price

You can ensure that the value entered as a price is formatted correctly prior to submission by matching it against a simple regular expression:

function checkPriceFormat(price) {
  let validRegex = /^-?[0-9]+(\.[0-9]+)?$/;

  return validRegex.test(price);
}

This function, checkPriceFormat(), will return true if the specified price string is formatted properly, or false if it's not.

Specifications

Browser compatibility

See also

• Payment Request API
• Using the Payment Request API
• Payment processing concepts