clarify wallet transactions API sorting

1 files changed, 6 insertions, 1 deletions

diff --git a/taler-wallet.rst b/taler-wallet.rst
index f9161211..379dba0c 100644
--- a/taler-wallet.rst
+++ b/taler-wallet.rst
@@ -102,7 +102,10 @@ Transactions are all operations or events that are affecting the balance.
   .. ts:def:: TransactionsResponse
 
     interface TransactionsResponse {
-      // a list of past and pending transactions
+      // a list of past and pending transactions sorted by pending, timestamp and transactionId.
+      // In case two events are both pending and have the same timestamp,
+      // they are sorted by the transactionId
+      // (lexically ascending and locale-independent comparison).
       transactions: Transaction[];
     }
 
@@ -120,6 +123,8 @@ Transactions are all operations or events that are affecting the balance.
       timestamp: Timestamp;
 
       // true if the transaction is still pending, false otherwise
+      // If a transaction is not longer pending, its timestamp will be updated,
+      // but its transactionId will remain unchanged
       pending: boolean;
 
       // Raw amount of the transaction (exclusive of fees or other extra costs)