From be7a2c47e649e6c7f81eaec23e6e71da8287590a Mon Sep 17 00:00:00 2001
From: Christian Grothoff <christian@grothoff.org>
Date: Fri, 27 Nov 2020 14:56:05 +0100
Subject: specify new /management/wire-fee endpoint

---
 core/api-exchange.rst | 46 ++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 46 insertions(+)

(limited to 'core/api-exchange.rst')

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).
-- 
cgit v1.2.3