more clearity in the comments of PolicyBrandtVickreyAuction

1 files changed, 7 insertions, 7 deletions

diff --git a/core/api-exchange.rst b/core/api-exchange.rst
index af49ad0f..91285f5d 100644
--- a/core/api-exchange.rst
+++ b/core/api-exchange.rst
@@ -2219,18 +2219,18 @@ proof to the seller for the escrow of sufficient fund.
 
       // Date until the auction must have been successfully executed and
       // a valid transcript provided to the 
-      // ``/extensions/policy_brandt-vickrey-auction``-endpoint of the
+      // ``/extensions/policy_brandt_vickrey_auction``-endpoint of the
       // exchange.
       //
       // [If the auction has not been executed by then] OR [has been executed
-      // before then, but this bidder did not win], the coins will not be
-      // transfered to the seller and can be refreshed by the owner of the
-      // coin.
+      // before then, but this bidder did not win], the coin's value doesn't
+      // change and the owner can refresh the coin.
       //
       // If this bidder won the auction, the winning price/amount from the
-      // outcome will substracted from the coin and transered to the seller.
-      // For any potentially remaining value, the bidder can refresh the coin
-      // to retrieve change.
+      // outcome will be substracted from the coin and transfered to the
+      // merchant's ``payout_uri`` from the deposit request (minus a potential
+      // auction fee).  For any remaining value, the bidder can refresh the
+      // coin to retrieve change.
       deadline: Timestamp;
     }