verbosity

1 files changed, 9 insertions, 7 deletions

diff --git a/libeufin/api-sandbox.rst b/libeufin/api-sandbox.rst
index 134b50a9..c5372e5e 100644
--- a/libeufin/api-sandbox.rst
+++ b/libeufin/api-sandbox.rst
@@ -458,9 +458,10 @@ Cashouts
   ratio and fee to one input amount.  Typically, frontends
   ask this endpoint before creating cash-out operations.  There
   is **no** financial consequence to this endpoint and only
-  registered users are allowed to request. At least one of 
-  the two query parameters should be provided. Amounts should
-  always include the currency.
+  registered users are allowed to request.  At least one of 
+  the two query parameters should be provided.  If both are
+  given, then the server checks their correctness.  Amounts
+  must include the currency.
 
   **Request:**
 
@@ -475,10 +476,11 @@ Cashouts
   .. ts:def:: CashoutEstimate
 
     interface CashoutEstimate {
+      // Amount that the user will get deducted from their regional
+      // bank account, according to the 'amount_credit' value.
       amount_debit: Amount; 
       // Amount that the user will receive in their fiat
-      // bank account, after having TAN-confirmed the cash-out
-      // operation.
+      // bank account, according to 'amount_debit'.
       amount_credit: Amount; 
     }
 
@@ -486,8 +488,8 @@ Cashouts
   :http:statuscode:`200 Ok`:
     Response contains the calculated values
   :http:statuscode:`400 Bad request`:
-    Both parameters have been provided and the calculation is not correct or
-    none of them has been provided.
+    Both parameters have been provided and the calculation is not correct,
+    or none of them has been provided.
 
 .. _cashout-rates: