POST /management/drain

This request is used to drain profits from the exchange’s escrow account to another regular bank account of the exchange. The actual drain requires running the taler-exchange-drain tool.

Request:

The request must be a DrainProfitsMessage.

Response:

204 No content:

The profit drain was scheduled.

403 Forbidden:

The master signature is invalid. Returned with an error code of TALER_EC_EXCHANGE_MANAGEMENT_DRAIN_PROFITS_SIGNATURE_INVALID.

413 Request entity too large:

The uploaded body is to long, it exceeds the size limit. Returned with an error code of TALER_EC_GENERIC_UPLOAD_EXCEEDS_LIMIT.

500 Internal server error:

The server encountered an internal error processing the request. Returned with an error code of TALER_EC_GENERIC_DB_STORE_FAILED.

Details:

interface DrainProfitsMessage {

  // Configuration section of the account to debit.
  debit_account_section: string;

  // Full payto URI of the account to credit.
  credit_payto_uri: string;

  // Wire transfer identifier to use.
  wtid: Base32;

  // Signature by the exchange master key over a
  // TALER_MasterDrainProfitPS.
  // Must have purpose TALER_SIGNATURE_MASTER_DRAIN_PROFITS.
  master_sig: EddsaSignature;

  // When was the message created.
  date: Timestamp;

  // Amount to be drained.
  amount: Amount;

}