[GNUnet-SVN] [taler-api] branch master updated: expand contract specification to include wire fee details

[gnunet]

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

grothoff pushed a commit to branch master
in repository api.

The following commit(s) were added to refs/heads/master by this push:
     new 2373aa4  expand contract specification to include wire fee details
2373aa4 is described below

commit 2373aa4e1ada44d39932c7c662388bd451bc9451
Author: Christian Grothoff <address@hidden>
AuthorDate: Sun Mar 5 18:40:28 2017 +0100

    expand contract specification to include wire fee details
---
 api/api-merchant.rst | 17 ++++++++++++++++-
 1 file changed, 16 insertions(+), 1 deletion(-)

diff --git a/api/api-merchant.rst b/api/api-merchant.rst
index 3bad491..5b0e71e 100644
--- a/api/api-merchant.rst
+++ b/api/api-merchant.rst
@@ -477,6 +477,21 @@ The `offer` must have the following structure:
       // Maximum total deposit fee accepted by the merchant for this contract
       max_fee: Amount;
 
+      // Maximum wire fee accepted by the merchant (customer share to be
+      // divided by the 'wire_fee_amortization' factor, and further reduced
+      // if deposit fees are below 'max_fee').  Default if missing is zero.
+      max_wire_fee: Amount;
+
+      // Over how many customer transactions does the merchant expect to
+      // amortize wire fees on average?  If the exchange's wire fee is
+      // above 'max_wire_fee', the difference is divided by this number
+      // to compute the expected customer's contribution to the wire fee.
+      // The customer's contribution may further be reduced by the difference
+      // between the 'max_fee' and the sum of the actual deposit fees.
+      // Optional, default value if missing is 1.  0 and negative values are
+      // invalid and also interpreted as 1.
+      wire_fee_amortization: Integer;
+
       // A free-form identifier for this transaction.
       transaction_id: string;
 
@@ -512,7 +527,7 @@ The `offer` must have the following structure:
       locations: { [label: string]: [location: Location], ... };
 
       // Extra data that is only interpreted by the merchant frontend.
-      // Useful when the merchant needs to store extra information on a 
+      // Useful when the merchant needs to store extra information on a
       // contract without storing it separately in their database.
       extra: any;
     }

-- 
To stop receiving notification emails like this one, please contact
address@hidden