diff options
author | Thien-Thi Nguyen <ttn@gnuvola.org> | 2021-03-12 04:10:47 -0500 |
---|---|---|
committer | Thien-Thi Nguyen <ttn@gnuvola.org> | 2021-03-12 04:10:47 -0500 |
commit | 5d64658dbc24e9aaa0c4a46598635792cff2fe5d (patch) | |
tree | cdf6099e59b16417a89ba8022a9fae5886a202a2 /taler-mcig.rst | |
parent | 3bb8e8c374807cb245bbbceff68cbe94e4d6528d (diff) | |
download | docs-5d64658dbc24e9aaa0c4a46598635792cff2fe5d.tar.gz docs-5d64658dbc24e9aaa0c4a46598635792cff2fe5d.tar.bz2 docs-5d64658dbc24e9aaa0c4a46598635792cff2fe5d.zip |
rewrite "auto-refund period" details per CG feedback
Diffstat (limited to 'taler-mcig.rst')
-rw-r--r-- | taler-mcig.rst | 24 |
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. |