rewrite "auto-refund period" details per CG feedback

1 files changed, 11 insertions, 13 deletions

diff --git a/taler-mcig.rst b/taler-mcig.rst
index 57ca4b1f..134970b0 100644
--- a/taler-mcig.rst
+++ b/taler-mcig.rst
@@ -217,19 +217,17 @@ are demonstrated in the next section.
 **auto-refund period**
   The Taler protocol can automatically offer refunds to the customer's
   wallet without their explicit prompting during the auto-refund period.
-  FIXME: When is this useful?
-
-  FIXME: Is this the same as the refund deadline?
-
-  FIXME: API call?
-  This is useful if it is impossible to notify the customer
-  about a refund. Example is the Snack machine, where a failure
-  to dispense a product triggers a refund, but the snack machine
-  has no good way to tell the shopper that it has issued a refund.
-  So here, the wallet will _watch_ for say 5 minutes for an auto-refund,
-  which is automatically issued by the snack machine (if the optical
-  barrier detects that it could not dispense the product) and appears in the
-  wallet without the buyer needing to take any action.
+
+  This is useful in the case where the purchase cannot be fulfilled
+  (e.g. jammed vending machine), but there is no way to notify the
+  customer about a refund.
+
+  If specified, the customer's wallet will wait that long after
+  authorization (and before fulfillment) before automatically
+  receiving a refund.
+
+  To set the auto-refund period, specify ``auto_refund``
+  in :http:post:`[/instances/$INSTANCE]/private/orders`.
 
 **repurchase detection / prevention**
   Taler can detect a repurchase attempt and prevent it from going through.