document priorities

1 files changed, 12 insertions, 0 deletions

diff --git a/core/api-merchant.rst b/core/api-merchant.rst
index 0f606460..0e1ff018 100644
--- a/core/api-merchant.rst
+++ b/core/api-merchant.rst
@@ -3829,6 +3829,18 @@ It has the following structure:
     // The exchange's base URL.
     url: string;
 
+    // How much would the merchant like to use this exchange.
+    // The wallet should use a suitable exchange with high
+    // priority. The following priority values are used, but
+    // it should be noted that they are NOT in any way normative.
+    //
+    // 0: likely it will not work (recently seen with account
+    //    restriction that would be bad for this merchant)
+    // 512: merchant does not know, might be down (merchant
+    //    did not yet get /wire response).
+    // 1024: good choice (recently confirmed working)
+    priority: Integer;
+
     // Master public key of the exchange.
     master_pub: EddsaPublicKey;
   }