[GNUnet-SVN] [taler-api] branch master updated: add specification for aggregate wire transfers (#4929)

[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 66a3df7  add specification for aggregate wire transfers (#4929)
66a3df7 is described below

commit 66a3df73cabc1ab6251748c2c979eaccf4ead367
Author: Christian Grothoff <address@hidden>
AuthorDate: Thu Mar 2 07:33:41 2017 +0100

    add specification for aggregate wire transfers (#4929)
---
 api/api-exchange.rst | 35 ++++++++++++++++++++++++++++++++++-
 1 file changed, 34 insertions(+), 1 deletion(-)

diff --git a/api/api-exchange.rst b/api/api-exchange.rst
index 74cc9a3..876f163 100644
--- a/api/api-exchange.rst
+++ b/api/api-exchange.rst
@@ -257,6 +257,9 @@ Obtaining wire-transfer information
       // Salt used to sign, `base32`_ encoded
       salt: string;
 
+      // Wire transfer fee structure. Specifies aggregate wire transfer fees.
+      fees: AggregateTransferFee[];
+
       // Signaure of `TALER_MasterWireDetailsPS`_ with purpose 
TALER_SIGNATURE_MASTER_TEST_DETAILS
       // Note that the `h_sepa_details` field of `TALER_MasterWireDetailsPS`_ 
is computed
       // by concatenating all of the above fields (in the same order they 
appear) and then
@@ -275,19 +278,49 @@ Obtaining wire-transfer information
       // Legal name of the owner of the account
       receiver_name: string;
 
+      // Wire transfer fee structure. Specifies aggregate wire transfer fees.
+      fees: AggregateTransferFee[];
+
       // IBAN account number.
       iban: string;
 
       // BIC of the bank.
       bic: string;
 
-      // Signaure of `TALER_MasterWireDetailsPS`_ with purpose 
TALER_SIGNATURE_MASTER_SEPA_DETAILS
+      // Signature of `TALER_MasterWireDetailsPS`_ with purpose 
TALER_SIGNATURE_MASTER_SEPA_DETAILS
       // Note that the `h_sepa_details` field of `TALER_MasterWireDetailsPS`_ 
is computed
       // by concatenating all of the above fields (in the same order they 
appear) and then
       // by hashing the obtained concatenation.
       sig: EddsaSignature;
     }
 
+  Aggregate wire transfer fees representing the fees the exchange
+  charges per wire transfer to a merchant must be specified as an
+  array in all wire transfer response objects under `fees`.  The
+  respective array contains objects with the following members:
+
+  .. _AggregateTransferFee:
+  .. _tsref-type-AggregateTransferFee:
+  .. code-block:: tsref
+
+    interface AggregateTransferFee {
+      // Per transfer wire transfer fee.
+      wire_fee: Amount;
+
+      // What date (inclusive) does this fee go into effect?
+      // The different fees must cover the full time period in which
+      // any of the denomination keys are valid without overlap.
+      start_date: Timestamp;
+
+      // What date (exclusive) does this fee stop going into effect?
+      // The different fees must cover the full time period in which
+      // any of the denomination keys are valid without overlap.
+      end_date: Timestamp;
+
+      // Signature of `TALER_MasterWireFeePS`_ with purpose 
TALER_SIGNATURE_MASTER_WIRE_FEES
+      sig: EddsaSignature;
+    }
+
 ----------
 Withdrawal
 ----------

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