From 66a3df73cabc1ab6251748c2c979eaccf4ead367 Mon Sep 17 00:00:00 2001 From: Christian Grothoff Date: Thu, 2 Mar 2017 07:33:41 +0100 Subject: add specification for aggregate wire transfers (#4929) --- api/api-exchange.rst | 35 ++++++++++++++++++++++++++++++++++- 1 file changed, 34 insertions(+), 1 deletion(-) (limited to 'api') diff --git a/api/api-exchange.rst b/api/api-exchange.rst index 74cc9a3b..876f1631 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 ---------- -- cgit v1.2.3