# FeeWatch

Notification that a fee has been charged.

Endpoint: POST /fees/watch
Version: v2

## Header parameters:

  - `call-ref` (string)
    A call reference generated by the caller and unique to the caller to provide correlation between the caller and system with a maximum length of 255

  - `published-timestamp` (integer, required)
    The timestamp, expressed in Epoch timestamp using millisecond precision, when this event was published.

  - `signature-v2` (string, required)
    The signature to verify the authenticity of this request.  This is the base64 hash (HmacSHA256) of the call-ref + payload + published-timestamp using your API key.

  - `signature` (string, required)
    The signature to verify the authenticity of this request.  This is the base64 hash (HmacSHA256) of the published-timestamp using your API key.

## Request fields (application/json):

  - `chargeFee` (object, required)

  - `chargeFee.id` (string, required)

  - `chargeFee.feeType` (string, required)
    Enum: "DEPOSIT", "WITHDRAWAL", "PURCHASE", "REFUND", "ATM_WITHDRAWAL", "CHARGEBACK", "TRANSFER", "SEND", "OWT", "CUSTOM", "OTHER"

  - `chargeFee.feeSubType` (string)
    Optional sub fee type value (e.g. PRINTED_STATEMENT)

  - `chargeFee.note` (string)
    Note added to the transaction and visible in the statements as an additional field

  - `chargeFee.source` (object, required)

  - `chargeFee.source.type` (string, required)
    Enum: "managed_cards", "managed_accounts"

  - `chargeFee.feeSpec` (object, required)

  - `chargeFee.feeSpec.flatAmount` (array)
    The flat fee amounts to be taken per currency. Required for FLAT, MAX, MIN and PLUS fee types.

  - `chargeFee.feeSpec.flatAmount.currency` (string, required)
    The currency expressed in ISO-4217 code. Example: GBP, EUR, USD.

  - `chargeFee.feeSpec.flatAmount.amount` (string, required)
    The monetary amount, scaled to the lowest denomination of the currency.

  - `chargeFee.feeSpec.percentage` (object)
    The percentage amount to be taken as a fee. Required for PERCENTAGE, MAX, MIN and PLUS fee types.

  - `chargeFee.feeSpec.percentage.value` (string)

  - `chargeFee.feeSpec.percentage.scale` (integer)

  - `chargeFee.batch` (object)
    The transaction batch if a transaction was executed for the charge

  - `chargeFee.batch.transaction` (object, required)

  - `chargeFee.batch.relatedBatchId` (string)

  - `chargeFee.batch.intercept` (array)

  - `chargeFee.batch.intercept.provider` (string, required)

  - `chargeFee.batch.intercept.state` (string)
    Enum: "PENDING", "ALLOWED", "DENIED", "FAILED", "SUSPENDED"

  - `chargeFee.batch.intercept.denialReason` (string)

  - `chargeFee.batch.intercept.suspendedReason` (string)

  - `chargeFee.batch.instrument` (object, required)
    The id of the map should be the instrument id

  - `chargeFee.batch.forexTrade` (array)

  - `chargeFee.batch.forexTrade.conflict` (string)
    Enum: "NO_FOREX_TRADE_ERROR", "RATE_EXPIRED"

  - `chargeFee.batch.forexTrade.executedTimestamp` (string)
    Epoch timestamp using millisecond precision.

  - `chargeFee.batch.forexTrade.compensatedRateId` (string)

  - `chargeFee.batch.forexTrade.sourceSystemCompensation` (string)
    The difference between the source and the actual compensation amount, may be positive (profit) or negative (loss)

  - `chargeFee.batch.forexTrade.compensatedRate` (object)
    The compensation forex rate between unscaled amount of given currencies

  - `chargeFee.batch.forexTrade.compensatedTimestamp` (string)
    Epoch timestamp using millisecond precision.

  - `chargeFee.batch.completedTimestamp` (string)
    Epoch timestamp using millisecond precision.

  - `chargeFee.batch.authSessionId` (string)

  - `chargeFee.batch.note` (string)

  - `chargeFee.profileId` (string)

  - `publishedTimestamp` (string, required)
    Epoch timestamp using millisecond precision.


## Response 204 fields