From ab61e5ebd3f2d2ebce9374ff04942a2cc6c1704b Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Marcos=20C=C3=A1ceres?= <marcos@marcosc.com>
Date: Mon, 19 Mar 2018 17:21:16 +1100
Subject: [PATCH 1/3] Remove `currencySystem` member

---
 index.html | 58 ++++++++----------------------------------------------
 1 file changed, 8 insertions(+), 50 deletions(-)

diff --git a/index.html b/index.html
index 5428acff..63954a46 100644
--- a/index.html
+++ b/index.html
@@ -118,12 +118,6 @@ <h2>
           before proceeding along the W3C Recommendation track.
         </p>
         <ul>
-          <li>
-            <a data-lt=
-            "PaymentCurrencyAmount.currencySystem">currencySystem</a> (see
-            <a href="https://github.com/w3c/payment-request/issues/617">issue
-            617</a>).
-          </li>
           <li data-link-for="PaymentItem">
             <a>PaymentItem</a>'s <a>type</a> member and the
             <a>PaymentItemType</a> enum (see <a href=
@@ -1387,55 +1381,27 @@ <h2>
         dictionary PaymentCurrencyAmount {
           required DOMString currency;
           required DOMString value;
-          // Note: currencySystem is "at risk" of being removed!
-          DOMString currencySystem = "urn:iso:std:iso:4217";
         };
       </pre>
       <p>
         A <a>PaymentCurrencyAmount</a> dictionary is used to supply monetary
         amounts.
       </p>
-      <div class="issue atrisk">
-        <p>
-          This feature has been marked "<a>at risk</a>". If you'd like for this
-          feature to remain in the specification, please describe your use case
-          in <a href="https://github.com/w3c/payment-request/issues/490">issue
-          490</a>.
-        </p>
-        <dl>
-          <dt>
-            <dfn>currencySystem</dfn> member
-          </dt>
-          <dd>
-            A URL that indicates the currency system that the <a>currency</a>
-            identifier belongs to. By default, the value is
-            "<code>urn:iso:std:iso:4217</code>" indicating that <a>currency</a>
-            is defined by [[!ISO4217]] (for example, <code>USD</code> for US
-            Dollars).
-          </dd>
-        </dl>
-      </div>
       <dl>
         <dt>
           <dfn>currency</dfn> member
         </dt>
         <dd>
           <p>
-            A string containing a currency identifier. The value of
-            <a>currency</a> can be any string that is valid within the currency
-            system indicated by <a>currencySystem</a>.
-          </p>
-          <p>
-            When using [[!ISO4217]], all <a data-cite=
+            A [[!ISO4217]] <a data-cite=
             "!ecma-402#sec-iswellformedcurrencycode">well-formed</a> 3-letter
-            alphabetic codes are allowed (i.e., the numeric codes are not
-            supported). Their canonical form is upper case. However, the set of
-            combinations of currency code for which localized currency symbols
-            are available is implementation dependent. Where a localized
-            currency symbol is not available, a user agent SHOULD use U+00A4
-            (¤) for formatting. User agents MAY format the display of the
-            <a>currency</a> member to adhere to OS conventions (e.g., for
-            localization purposes).
+            alphabetic code (i.e., the numeric codes are not supported). Their
+            canonical form is upper case. However, the set of combinations of
+            currency code for which localized currency symbols are available is
+            implementation dependent. Where a localized currency symbol is not
+            available, a user agent SHOULD use U+00A4 (¤) for formatting. User
+            agents MAY format the display of the <a>currency</a> member to
+            adhere to OS conventions (e.g., for localization purposes).
           </p>
         </dd>
         <dt>
@@ -1486,11 +1452,6 @@ <h3>
           steps:
         </p>
         <ol data-link-for="PaymentCurrencyAmount">
-          <li data-tests=
-          "PaymentCurrencyAmount/currencySystem-member.https.html">If
-          <var>amount</var>.<a>currencySystem</a> is not
-          "<code>urn:iso:std:iso:4217</code>", throw a <a>TypeError</a>.
-          </li>
           <li>Let <var>isValidCurrency</var> be the result of calling
           <a data-cite=
           "!ecma-402#sec-iswellformedcurrencycode">IsWellFormedCurrencyCode</a>
@@ -1516,9 +1477,6 @@ <h3>
           steps:
         </p>
         <ol data-link-for="PaymentCurrencyAmount">
-          <li>If <var>total</var>.<a>currencySystem</a> is not
-          "<code>urn:iso:std:iso:4217</code>", terminate this algorithm.
-          </li>
           <li>
             <a>Check and canonicalize amount</a> <var>amount</var>. Rethrow any
             exceptions.

From 2642114b67404d3091258959a81bf9e284e0b40c Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Marcos=20C=C3=A1ceres?= <marcos@marcosc.com>
Date: Fri, 6 Apr 2018 13:40:58 +1000
Subject: [PATCH 2/3] Editorial: add note about digital currencies

---
 index.html | 36 ++++++++++++++++++++++++++++++++++++
 1 file changed, 36 insertions(+)

diff --git a/index.html b/index.html
index 63954a46..7b621e77 100644
--- a/index.html
+++ b/index.html
@@ -1403,6 +1403,42 @@ <h2>
             agents MAY format the display of the <a>currency</a> member to
             adhere to OS conventions (e.g., for localization purposes).
           </p>
+          <div class="note" title=
+          "Digital currencies and ISO 4217 currency codes">
+            <p>
+              User agents implementing this specification enforce [[ISO4217]]'s
+              3-letter codes format via ECMAScript’s <a data-cite=
+              "!ecma-402#sec-iswellformedcurrencycode">isWellFormedCurrencyCode</a>
+              abstract operation, which is invoked as part of the <a>check and
+              canonicalize amount</a> algorithm. When a code does not adhere to
+              the [[ISO4217]] defined format, a <a>RangeError</a> is thrown.
+            </p>
+            <p>
+              Current implementations will therefore allow the use of
+              well-formed currency codes that are not part of the official
+              [[ISO4217]] list (e.g., XBT, XRP, etc.). If the provided code is
+              a currency that the browser knows how to display, then an
+              implementation will generally display the appropriate currency
+              symbol in the user interface (e.g., "USD" is shown as "$", "GBP"
+              is "£", and the non-standard "XBT" could be shown as "Ƀ"). When a
+              code can't be matched, the specification recommends browsers show
+              a scarab "¤".
+            </p>
+            <p>
+              Efforts are underway at ISO to account for digital currencies,
+              which may result in an update to the [[ISO4217]] registry or an
+              entirely new registry. The community expects this will resolve
+              ambiguities that have crept in through the use of non-standard
+              3-letter codes; for example, does "BTC" refer to Bitcoin or to a
+              future Bhutan currency? At the time of publication, it remains
+              unclear what form this evolution will take, or even the time
+              frame in which the work will be completed. The W3C Web Payments
+              Working Group is liaising with ISO during this evolutionary
+              process to ensure digital currencies are well supported both in
+              future versions of [[ISO4217]] and in future revisions of this
+              specification.
+            </p>
+          </div>
         </dd>
         <dt>
           <dfn>value</dfn> member

From 9183278a151a5a9a0ea8d948fc53eb52ebe9f870 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Marcos=20C=C3=A1ceres?= <marcos@marcosc.com>
Date: Wed, 25 Apr 2018 11:13:50 +1000
Subject: [PATCH 3/3] Review feedback from Ian

---
 index.html | 11 +++++------
 1 file changed, 5 insertions(+), 6 deletions(-)

diff --git a/index.html b/index.html
index 7b621e77..20ab097f 100644
--- a/index.html
+++ b/index.html
@@ -1421,8 +1421,8 @@ <h2>
               implementation will generally display the appropriate currency
               symbol in the user interface (e.g., "USD" is shown as "$", "GBP"
               is "£", and the non-standard "XBT" could be shown as "Ƀ"). When a
-              code can't be matched, the specification recommends browsers show
-              a scarab "¤".
+              code cannot be matched, the specification recommends browsers
+              show a scarab "¤".
             </p>
             <p>
               Efforts are underway at ISO to account for digital currencies,
@@ -1433,10 +1433,9 @@ <h2>
               future Bhutan currency? At the time of publication, it remains
               unclear what form this evolution will take, or even the time
               frame in which the work will be completed. The W3C Web Payments
-              Working Group is liaising with ISO during this evolutionary
-              process to ensure digital currencies are well supported both in
-              future versions of [[ISO4217]] and in future revisions of this
-              specification.
+              Working Group is liaising with ISO so that, in the future,
+              revisions to this specification remain compatible with relevant
+              ISO registries.
             </p>
           </div>
         </dd>