diff --git a/index.html b/index.html index 350ede5c..42164ff4 100644 --- a/index.html +++ b/index.html @@ -963,7 +963,7 @@

method specific data for those methods.

- The following fields are part of the PaymentMethodData + The following members are part of the PaymentMethodData dictionary:

@@ -1001,9 +1001,6 @@

A PaymentCurrencyAmount dictionary is used to supply monetary amounts.

-

- The following fields are required: -

currencySystem @@ -1061,7 +1058,7 @@

"PaymentRequestUpdateEvent.updateWith">updateWith().

- The following fields are part of the PaymentDetails dictionary: + The following members are part of the PaymentDetails dictionary:

@@ -1101,26 +1098,29 @@

"PaymentRequest.shippingAddress">shippingAddress.

- If an item in the sequence has the selected field set - to true, then this is the shipping option that will be used by - default and shippingOption will be set to - the id of this option without running the shipping - option changed algorithm. Authors SHOULD NOT set - selected to true on more than one item. If more than - one item in the sequence has selected set to true, - then user agents MUST select the last one in the sequence. + If an item in the sequence has the selected member set to true, + then this is the shipping option that will be used by default and + shippingOption will be set to the id of this option without running + the shipping option changed algorithm. Authors SHOULD NOT + set selected to + true on more than one item. If more than one item in the sequence + has selected set to + true, then user agents MUST select the last one in the + sequence.

- The shippingOptions field is only used if the + The shippingOptions member is only used if the PaymentRequest was constructed with PaymentOptions requestShipping set to true.

- If the sequence has an item with the selected field - set to true, then authors are responsible for ensuring that the - total field includes the cost of the shipping option. + If the sequence has an item with the selected member set to true, + then authors are responsible for ensuring that the + total member includes the cost of the shipping option. This is because no shippingoptionchange event will be fired for this option unless the user selects an alternative option first. @@ -1141,7 +1141,7 @@

When the payment request is updated using updateWith(), the PaymentDetails can contain a message in the error - field that will be displayed to the user. For example, this might + member that will be displayed to the user. For example, this might commonly be used to explain why goods cannot be shipped to the chosen shipping address.

@@ -1168,15 +1168,15 @@

The PaymentDetailsModifier dictionary provides details that modify the PaymentDetails based on payment method - identifier. It contains the following fields: + identifier. It contains the following members:

supportedMethods
- The supportedMethods field contains a sequence of payment - method identifiers. The remaining fields in the + The supportedMethods member contains a sequence of payment + method identifiers. The remaining members in the PaymentDetailsModifier apply only if the user selects a payment method included in this sequence.
@@ -1184,21 +1184,22 @@

total

- This PaymentItem value overrides the total field + This PaymentItem value overrides the total member in the PaymentDetails dictionary for the payment method - identifiers in the supportedMethods field. + identifiers in the supportedMethods member.
additionalDisplayItems
This sequence of PaymentItem dictionaries provides additional - display items that are appended to the displayItems - field in the PaymentDetails dictionary for the payment - method identifiers in the supportedMethods field. - This field is commonly used to add a discount or surcharge line item - indicating the reason for the different total amount for - the selected payment method that the user agent MAY display. + display items that are appended to the displayItems member in the + PaymentDetails dictionary for the payment method + identifiers in the supportedMethods member. This member is + commonly used to add a discount or surcharge line item indicating the + reason for the different total amount for the selected + payment method that the user agent MAY display.

It is the developer's responsibility to verify that the total amount is the sum of the @@ -1210,9 +1211,9 @@

data

- data is an object that provides optional information - that might be needed by the supported payment methods. If supplied, - it will be JSON-serialized. + data is an object that provides optional information that + might be needed by the supported payment methods. If supplied, it + will be JSON-serialized.
@@ -1224,7 +1225,7 @@

enum PaymentShippingType { "shipping", "delivery", - "pickup" + "pickup", };
@@ -1252,7 +1253,7 @@

-
+

PaymentOptions dictionary

@@ -1265,15 +1266,11 @@

PaymentShippingType shippingType = "shipping"; }; -

+

The PaymentOptions dictionary is passed to the PaymentRequest constructor and provides information about the options desired for the payment request.

-

- The following fields MAY be passed to the PaymentRequest - constructor: -

requestPayerName @@ -1319,18 +1316,17 @@

Some transactions require an address for delivery but the term "shipping" isn't appropriate. For example, "pizza delivery" not "pizza shipping" and "laundry pickup" not "laundry shipping". If - requestShipping is set to true, then the - shippingType field may be used to influence the way the - user agent presents the user interface for gathering the - shipping address. + requestShipping is set to true, then the shippingType + member may be used to influence the way the user agent + presents the user interface for gathering the shipping address.

- The shippingType field only affects the user interface - for the payment request. + The shippingType member only affects the user interface for + the payment request.

-
+

PaymentItem dictionary

@@ -1346,9 +1342,6 @@

in the PaymentDetails dictionary to indicate what the payment request is for and the value asked for.

-

- The following fields are required: -

label @@ -1368,11 +1361,11 @@

pending

- When set to true this flag means that the amount field - is not final. This is commonly used to show items such as shipping or - tax amounts that depend upon selection of shipping address or - shipping option. User agents MAY indicate pending fields in - the user interface for the payment request. + When set to true this flag means that the amount member is not + final. This is commonly used to show items such as shipping or tax + amounts that depend upon selection of shipping address or shipping + option. User agents MAY indicate pending fields in the user + interface for the payment request.

@@ -1474,7 +1467,7 @@

recipient
- This is the name of the recipient or contact person. This field may, + This is the name of the recipient or contact person. This member may, under certain circumstances, contain multiline information. For example, it might contain "care of" information.
@@ -1489,7 +1482,8 @@

If the requestShipping flag was set to true in the PaymentOptions passed to the PaymentRequest constructor, then the user agent will - populate the shippingAddress field of the + populate the shippingAddress member of the PaymentRequest and ultimately the PaymentResponse object with the user's selected shipping address after the user has accepted the payment. @@ -1508,15 +1502,12 @@

};

- The PaymentShippingOption dictionary has fields describing a + The PaymentShippingOption dictionary has members describing a shipping option. A web page can provide the user with one or more shipping options by calling the updateWith() method in response to a change event.

-

- The following fields are required: -

id @@ -1607,10 +1598,9 @@

Promise<void> complete(optional PaymentComplete result = "unknown"); }; -

+

A PaymentResponse is returned when a user has selected a payment - method and approved a payment request. It contains the following - fields: + method and approved a payment request.

@@ -1974,7 +1964,7 @@

not U+002D HYPHEN-MINUS, then copy details.total to the total field of + "PaymentDetails.total">total member of target.[[\details]]. (Negative total amounts are ignored.) @@ -1993,7 +1983,7 @@

details.displayItems to the displayItems - field of target.[[\details]]. + member of target.[[\details]]. @@ -2112,7 +2102,7 @@

  • Copy options to the shippingOptions field + "PaymentDetails.shippingOptions">shippingOptions member of target.[[\details]].