[Payments] Normalize billing address before sending to the merchant.

chrome/android/java/src/org/chromium/chrome/browser/payments/PaymentInstrument.java

Index: chrome/android/java/src/org/chromium/chrome/browser/payments/PaymentInstrument.java
diff --git a/chrome/android/java/src/org/chromium/chrome/browser/payments/PaymentInstrument.java b/chrome/android/java/src/org/chromium/chrome/browser/payments/PaymentInstrument.java
index c799a7814d292cdd7bc2d8c0ae2cbdbe67d61180..8c48f833c963c7442c39e8a22c966c9ad7c7c5f6 100644
--- a/chrome/android/java/src/org/chromium/chrome/browser/payments/PaymentInstrument.java
+++ b/chrome/android/java/src/org/chromium/chrome/browser/payments/PaymentInstrument.java
@@ -4,11 +4,11 @@
 
 package org.chromium.chrome.browser.payments;
 
+import org.json.JSONObject;
+
 import org.chromium.chrome.browser.payments.ui.PaymentOption;
 import org.chromium.payments.mojom.PaymentItem;
 
-import org.json.JSONObject;
-
 import java.util.List;
 
 /**
@@ -28,6 +28,11 @@ public abstract class PaymentInstrument extends PaymentOption {
         void onInstrumentDetailsReady(String methodName, String stringifiedDetails);
 
         /**
+         * Called when loading the instrument details.

[please use gerrit instead, 2016/10/17 20:44:18]

Please elaborate a bit more on this comment. This callback is important because
the instrument is not showing any UI, but the onInstrumentDetailsReady/Error()
has not been called yet. So the PaymentRequestUI should show it's own
"Loading..." UI at this time.

[sebsg, 2016/10/18 14:38:19]

Done.

+         */
+        void loadingInstrumentDetails();

[please use gerrit instead, 2016/10/17 20:44:18]

Let's move this callback to be the first one in the interface. When thinking
about the time progression, this is called before
onInstrumentDetailsReady/Error(). So it would make sense to also place
"loading..." callback above these "ready" and "error" callbacks.

[sebsg, 2016/10/18 14:38:19]

Done.

+
+        /**
          * Called if unable to retrieve instrument details.
          */
         void onInstrumentDetailsError();