commit 5d64658dbc24e9aaa0c4a46598635792cff2fe5d
parent 3bb8e8c374807cb245bbbceff68cbe94e4d6528d
Author: Thien-Thi Nguyen <ttn@gnuvola.org>
Date: Fri, 12 Mar 2021 04:10:47 -0500
rewrite "auto-refund period" details per CG feedback
Diffstat:
1 file changed, 11 insertions(+), 13 deletions(-)
diff --git 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.
