spec for exchange protocol v19

1 files changed, 11 insertions, 2 deletions

diff --git a/core/api-exchange.rst b/core/api-exchange.rst
index 5a734795..d41372d8 100644
--- a/core/api-exchange.rst
+++ b/core/api-exchange.rst
@@ -3876,12 +3876,21 @@ typically also view the balance.)
       // Coin's public key, both ECDHE and EdDSA.
       coin_pub: CoinPublicKey;
 
-      // The total amount the original deposit was worth.
+      // The total amount the original deposit was worth,
+      // including fees and after applicable refunds.
       deposit_value: Amount;
 
-      // Applicable fees for the deposit.
+      // Applicable fees for the deposit, possibly
+      // reduced or waived due to refunds.
       deposit_fee: Amount;
 
+      // Refunds that were applied to the value of
+      // this coin. Optional.
+      // Since protocol **v19**.  Before, refunds were
+      // incorrectly still included in the
+      // ``deposit_value`` (!).
+      refund_total?: Amount;
+
     }
 
 .. http:get:: /deposits/$H_WIRE/$MERCHANT_PUB/$H_CONTRACT_TERMS/$COIN_PUB