diff --git a/specs/method-identifiers.html b/specs/method-identifiers.html index 6e43d9a8..b953763e 100644 --- a/specs/method-identifiers.html +++ b/specs/method-identifiers.html @@ -58,7 +58,7 @@

The Payment Request API [[!PAYMENTREQUESTAPI]] requires that merchants supply a list - identifiers for supported payment methods. This document defines those identifier + of identifiers for supported payment methods. This document defines those identifier strings and how they are created.

@@ -76,7 +76,7 @@ Web Platform Incubator Community Group.

- +

Introduction

@@ -93,7 +93,7 @@

Requirements for identifiers

There are a set of requirements that the payment method identifiers are designed to support:

  1. It must be possible for the Working Group to mint a payment method identifier for any payment method.
  2. -
  3. It must be possible for the anyone to mint a payment method identifier for a payment method under their control.
  4. +
  5. It must be possible for anyone to mint a payment method identifier for a payment method under their control.
  6. It should be possible to use a standard short string to identify common payment methods.
  7. It must be possible for someone minting a non-standard identifier to make it globally unique in a cost-effective manner.
@@ -104,10 +104,10 @@

Payment Method Identifier

The Payment Method Identifier is a string that uniquely identifies a payment method that a user can use to complete a transaction. For example, Visa, MasterCard, and American Express are payment methods used in some countries.

-
+
This document currently specifies multiple alternate options for payment method identifiers. The Working Group has - not yet selected an approach, which might be one documented in this specification or another as yet undocumented proposal.
+ not yet selected an approach. The chosen approach might be one documented in this specification or another as yet undocumented proposal.

Option 1a

@@ -201,7 +201,7 @@

Discussion topics

  • Developers may find it confusing to us a URL if it isn't intended to point to a resource.
  • Overloading the same string to mean an identifier in some cases and a resource location in others is undesirable. The intent of a URL is to load or locate a resource and may only be done sometimes with this proposal. A URL might mistakenly be crafted as an identifier but later lead to attempts to load it that weren't anticipated (by potentially large numbers of users).
  • -
  • Experience with XML namespaces suggests that optional downloading resources from identifiers tends to encourage +
  • Experience with XML namespaces suggests that optionally downloading resources from identifiers tends to encourage user agents to hard code common identifiers for performance reasons potentially leading to a closed or unbalanced system.