Support fine-grained errors for payment methods (#752)

marcoscaceres · web-flow · commit 1816526e2f36 · 2018-08-10T15:32:10.000+10:00
diff --git a/index.html b/index.html
@@ -981,7 +981,8 @@ <h2>
               <li>If required by the specification that defines the
               <var>identifer</var>, then <a data-cite=
               "!WEBIDL#dfn-convert-ecmascript-to-idl-value">convert</a>
-              <var>data</var> to an IDL value. Otherwise, <a data-cite=
+              <var>data</var> to an IDL value of the type specified there.
+              Otherwise, <a data-cite=
               "!WEBIDL#dfn-convert-ecmascript-to-idl-value">convert</a> to
               <a data-cite="!WEBIDL#idl-object">object</a>.
               </li>
@@ -3226,10 +3227,31 @@ <h2>
           </li>
           <li data-link-for="PaymentValidationErrors" data-tests=
           "payment-request/PaymentValidationErrors/retry-shows-error-member-manual.https.html">
-          By matching the members of <var>errorFields</var> to input fields in
-          the user agent's UI, indicate to the end-user that something is wrong
-          with the data of the payment response. For example, a user agent
-          might draw the user's attention to the erroneous
+          If <var>errorFields</var>'s <a>paymentMethod</a> member was passed,
+          and if required by the specification that defines
+          <var>response</var>'s <a>payment method</a>, then <a data-cite=
+          "!WEBIDL#dfn-convert-ecmascript-to-idl-value">convert</a>
+          <var>errorFields</var> <a>paymentMethod</a> to an IDL value of the
+          type specified there. Otherwise, <a data-cite=
+          "!WEBIDL#dfn-convert-ecmascript-to-idl-value">convert</a> to
+          <a data-cite="!WEBIDL#idl-object">object</a>.
+          </li>
+          <li>If conversion results in a <a data-cite="!WEBIDL#dfn-exception">
+            exception</a> <var>error</var>:
+            <ol>
+              <li>Reject <var>retryPromise</var> with <var>error</var>.
+              </li>
+              <li>Set <a>user agent</a>'s <a>payment request is showing</a>
+              boolean to false.
+              </li>
+              <li>Return.
+              </li>
+            </ol>
+          </li>
+          <li>By matching the members of <var>errorFields</var> to input fields
+          in the user agent's UI, indicate to the end-user that something is
+          wrong with the data of the payment response. For example, a user
+          agent might draw the user's attention to the erroneous
           <var>errorFields</var> in the browser's UI and display the value of
           each field in a manner that helps the user fix each error. Similarly,
           if the <a>error</a> member is passed, present the error in the user
@@ -3273,6 +3295,7 @@ <h3>
               PayerErrorFields payer;
               AddressErrors shippingAddress;
               DOMString error;
+              object paymentMethod;
             };
           </pre>
           <dl>
@@ -3300,6 +3323,14 @@ <h3>
               can be passed in combination with other members of the
               <a>PaymentValidationErrors</a> dictionary.
             </dd>
+            <dt>
+              <dfn>paymentMethod</dfn> member
+            </dt>
+            <dd>
+              A payment method specific errors. See, for example,
+              [[payment-method-basic-card]]'s <code><a data-cite=
+              "payment-method-basic-card#basiccarderrorfields-dictionary">BasicCardErrorFields</a></code>.
+            </dd>
           </dl>
         </section>
         <section data-dfn-for="PayerErrorFields" data-link-for=
