taler-docs

Documentation for GNU Taler components, APIs and protocols
Log | Files | Refs | README | LICENSE

post-management-wire-fee.rst (1113B)


      1 .. http:post:: /management/wire-fee
      2 
      3   This request is used to configure wire fees.
      4 
      5   **Request:**
      6 
      7   The request must be a `WireFeeSetupMessage`.
      8 
      9   **Response:**
     10 
     11   :http:statuscode:`204 No content`:
     12     The wire fee was successfully configured.
     13   :http:statuscode:`403 Forbidden`:
     14     The master signature is invalid.
     15   :http:statuscode:`409 Conflict`:
     16     The exchange has a conflicting wire fee already set up.
     17 
     18   **Details:**
     19 
     20   .. ts:def:: WireFeeSetupMessage
     21 
     22     interface WireFeeSetupMessage {
     23 
     24       // Wire method the fee applies to.
     25       wire_method: string;
     26 
     27       // Signature using the exchange's offline key
     28       // with purpose ``TALER_SIGNATURE_MASTER_WIRE_FEES``.
     29       master_sig_wire: EddsaSignature;
     30 
     31       // When does the wire fee validity period start?
     32       fee_start: Timestamp;
     33 
     34       // When does the wire fee validity period end (exclusive).
     35       fee_end: Timestamp;
     36 
     37       // Closing fee to charge during that time period for this wire method.
     38       closing_fee: Amount;
     39 
     40       // Wire fee to charge during that time period for this wire method.
     41       wire_fee: Amount;
     42 
     43     }