diff options
author | Christian Grothoff <christian@grothoff.org> | 2019-12-05 14:59:22 +0100 |
---|---|---|
committer | Christian Grothoff <christian@grothoff.org> | 2019-12-05 14:59:22 +0100 |
commit | c3c23422efd929ead7f829b022ede4597c3c51b0 (patch) | |
tree | 098c3b8e6a16817e6fc4b9ce3a091506e42e8302 /core/api-merchant.rst | |
parent | e77ad2d80d240ba1cc8fb286fe8a7af56b881ee9 (diff) | |
download | docs-c3c23422efd929ead7f829b022ede4597c3c51b0.tar.gz docs-c3c23422efd929ead7f829b022ede4597c3c51b0.tar.bz2 docs-c3c23422efd929ead7f829b022ede4597c3c51b0.zip |
spec auto_refund
Diffstat (limited to 'core/api-merchant.rst')
-rw-r--r-- | core/api-merchant.rst | 19 |
1 files changed, 19 insertions, 0 deletions
diff --git a/core/api-merchant.rst b/core/api-merchant.rst index 4ee35d52..88d1c94d 100644 --- a/core/api-merchant.rst +++ b/core/api-merchant.rst @@ -821,6 +821,25 @@ The contract terms must have the following structure: // in this field when the proposal is generated. nonce: string; + // Specifies for how long the wallet should try to get an + // automatic refund for the purchase. If this field is + // present, the wallet should wait for a few seconds after + // the purchase and then automatically attempt to obtain + // a refund. The wallet should probe until "delay" + // after the payment was successful (i.e. via long polling + // or via explicit requests with exponential back-off). + // + // In particular, if the wallet is offline + // at that time, it MUST repeat the request until it gets + // one response from the merchant after the delay has expired. + // If the refund is granted, the wallet MUST automatically + // recover the payment. This is used in case a merchant + // knows that it might be unable to satisfy the contract and + // desires for the wallet to attempt to get the refund without any + // customer interaction. Note that it is NOT an error if the + // merchant does not grant a refund. + auto_refund?: RelativeTime; + // Extra data that is only interpreted by the merchant frontend. // Useful when the merchant needs to store extra information on a // contract without storing it separately in their database. |