diff --git a/index.html b/index.html index 350ede5c..42164ff4 100644 --- a/index.html +++ b/index.html @@ -963,7 +963,7 @@
- The following fields are part of the PaymentMethodData + The following members are part of the PaymentMethodData dictionary:
- The following fields are required: -
- The following fields are part of the PaymentDetails dictionary: + The following members are part of the PaymentDetails dictionary:
- 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 @@
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:
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.
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
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.
+
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: -
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.
- The following fields are required: -
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.
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: -
+
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.