GET /transfers/$WTID

Provides deposits associated with a given wire transfer. The wire transfer identifier (WTID) and the base URL for tracking the wire transfer are both given in the wire transfer subject.

Response:

200 OK:

The wire transfer is known to the exchange, details about it follow in the body. The body of the response is a TrackTransferResponse.

400 Bad Request:

The $WTID is malformed. This response comes with a standard ErrorDetail response with a code of TALER_EC_EXCHANGE_TRANSFERS_GET_WTID_MALFORMED.

404 Not found:

The wire transfer identifier is unknown to the exchange. Returned with an error code of TALER_EC_EXCHANGE_TRANSFERS_GET_WTID_NOT_FOUND.

500 Internal server error:

The exchange encountered an internal problem processing the request. Error codes used are: - TALER_EC_GENERIC_DB_FETCH_FAILED - TALER_EC_GENERIC_DB_INVARIANT_FAILURE - TALER_EC_GENERIC_JSON_ALLOCATION_FAILURE - TALER_EC_EXCHANGE_TRANSFERS_GET_WIRE_FEE_NOT_FOUND - TALER_EC_EXCHANGE_TRANSFERS_GET_WIRE_FEE_INCONSISTENT

interface TrackTransferResponse {
  // Actual amount of the wire transfer, excluding the wire fee.
  total: Amount;

  // Applicable wire fee that was charged.
  wire_fee: Amount;

  // Public key of the merchant (identical for all deposits).
  merchant_pub: EddsaPublicKey;

  // Hash of the payto:// account URI (identical for all deposits).
  h_payto: FullPaytoHash;

  // Time of the execution of the wire transfer by the exchange.
  execution_time: Timestamp;

  // Details about the deposits.
  deposits: TrackTransferDetail[];

  // Signature from the exchange made with purpose
  // TALER_SIGNATURE_EXCHANGE_CONFIRM_WIRE_DEPOSIT
  // over a TALER_WireDepositDataPS.
  exchange_sig: EddsaSignature;

  // Public EdDSA key of the exchange that was used to generate the signature.
  // Should match one of the exchange's signing keys from /keys.  Again given
  // explicitly as the client might otherwise be confused by clock skew as to
  // which signing key was used.
  exchange_pub: EddsaPublicKey;
}

interface TrackTransferDetail {
  // SHA-512 hash of the contact of the merchant with the customer.
  h_contract_terms: HashCode;

  // Coin's public key, both ECDHE and EdDSA.
  coin_pub: CoinPublicKey;

  // The total amount the original deposit was worth,
  // including fees and after applicable refunds.
  deposit_value: Amount;

  // Applicable fees for the deposit, possibly
  // reduced or waived due to refunds.
  deposit_fee: Amount;

  // Refunds that were applied to the value of
  // this coin. Optional.
  // @since protocol **v19**.  Before, refunds were
  // incorrectly still included in the
  // deposit_value (!).
  refund_total?: Amount;

}