[taler-docs] 02/02: rewrite "auto-refund period" details per CG feedback

[gnunet]

This is an automated email from the git hooks/post-receive script.

ttn pushed a commit to branch master
in repository docs.

commit 5d64658dbc24e9aaa0c4a46598635792cff2fe5d
Author: Thien-Thi Nguyen <ttn@gnuvola.org>
AuthorDate: Fri Mar 12 04:10:47 2021 -0500

    rewrite "auto-refund period" details per CG feedback
---
 taler-mcig.rst | 24 +++++++++++-------------
 1 file changed, 11 insertions(+), 13 deletions(-)

diff --git a/taler-mcig.rst b/taler-mcig.rst
index 57ca4b1..134970b 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.

-- 
To stop receiving notification emails like this one, please contact
gnunet@gnunet.org.