summaryrefslogtreecommitdiff
path: root/core/api-exchange.rst
diff options
context:
space:
mode:
authorChristian Grothoff <christian@grothoff.org>2020-11-27 14:56:05 +0100
committerChristian Grothoff <christian@grothoff.org>2020-11-27 14:56:05 +0100
commitbe7a2c47e649e6c7f81eaec23e6e71da8287590a (patch)
treeaec0342fa7db4cbc7a18ccb2e7be666a1dc81846 /core/api-exchange.rst
parentcd794638cc32a498ab2545c506d8c0af9bae5d7d (diff)
downloaddocs-be7a2c47e649e6c7f81eaec23e6e71da8287590a.tar.gz
docs-be7a2c47e649e6c7f81eaec23e6e71da8287590a.tar.bz2
docs-be7a2c47e649e6c7f81eaec23e6e71da8287590a.zip
specify new /management/wire-fee endpoint
Diffstat (limited to 'core/api-exchange.rst')
-rw-r--r--core/api-exchange.rst46
1 files changed, 46 insertions, 0 deletions
diff --git a/core/api-exchange.rst b/core/api-exchange.rst
index 3ce044aa..4d5d5121 100644
--- a/core/api-exchange.rst
+++ b/core/api-exchange.rst
@@ -654,6 +654,52 @@ Management operations authorized by master key
}
+.. http:post:: /management/wire-fee
+
+ This request will be used to configure wire fees.
+
+ **Request:**
+
+ The request must be a `WireFeeSetupMessage`.
+
+ **Response:**
+
+ :http:statuscode:`204 No content`:
+ The wire fee was successfully configured.
+ :http:statuscode:`403 Forbidden`:
+ The master signature is invalid.
+ :http:statuscode:`409 Conflict`:
+ The exchange has a conflicting wire fee already setup.
+
+ **Details:**
+
+ .. ts:def:: WireFeeSetupMessage
+
+ interface WireFeeSetupMessage {
+
+ // wire method the fee applies to
+ wire_method: string;
+
+ // Signature using the exchange's offline key
+ // with purpose TALER_SIGNATURE_MASTER_WIRE_FEES.
+ master_sig_wire: EddsaSignature;
+
+ // When does the wire fee validity period start?
+ fee_start: Timestamp;
+
+ // When does the wire fee validity period end (exclusive).
+ fee_end: Timestamp;
+
+ // Closing fee to charge during that time period for this wire method.
+ closing_fee: Amount;
+
+ // Wire fee to charge during that time period for this wire method.
+ wire_fee: Amount;
+
+ }
+
+
+
.. http:post:: /management/wire
This request will be used to enable a wire method (exchange bank account).