# Cash Balance Transfers events

Webhook callback payload for cash balance transfer lifecycle events. Delivered when a transfer transitions to `CASH_BALANCE_TRANSFER.ISSUED`, `CASH_BALANCE_TRANSFER.CONFIRMED`, or `CASH_BALANCE_TRANSFER.CANCELLED`.

Endpoint: POST Cash Balance Transfers events
Version: 1.147.0

## Request fields (application/json):

  - `id` (string, required)
    Event unique identifier

  - `created_at` (string, required)
    Date and time when the event was created. [RFC 3339-5](https://datatracker.ietf.org/doc/html/rfc3339#section-5.6), [ISO8601 UTC](https://www.iso.org/iso-8601-date-and-time-format.html)

  - `type` (string, required)
    Event type
    Enum: "CASH_BALANCE_TRANSFER.ISSUED", "CASH_BALANCE_TRANSFER.CONFIRMED", "CASH_BALANCE_TRANSFER.CANCELLED"

  - `object` (object, required)
    Represents an internal cash balance transfer between two account groups belonging to the same user and tenant. Only settled cash in the same currency can be transferred.

  - `object.id` (string, required)
    Cash balance transfer unique identifier

  - `object.created_at` (string, required)
    Date and time when the resource was created. [RFC 3339-5](https://datatracker.ietf.org/doc/html/rfc3339#section-5.6), [ISO8601 UTC](https://www.iso.org/iso-8601-date-and-time-format.html)

  - `object.updated_at` (string, required)
    Date and time when the resource was last updated. [RFC 3339-5](https://datatracker.ietf.org/doc/html/rfc3339#section-5.6), [ISO8601 UTC](https://www.iso.org/iso-8601-date-and-time-format.html)

  - `object.source_account_group_id` (string, required)
    The account group the cash is transferred from. Must differ from `target_account_group_id` and belong to the same user and tenant. Allowed account group types are `PERSONAL`, `CHILD`, and `BUSINESS`, and the source and target account groups must be of the same type.

  - `object.target_account_group_id` (string, required)
    The account group the cash is transferred to. Must differ from `source_account_group_id` and belong to the same user and tenant. Allowed account group types are `PERSONAL`, `CHILD`, and `BUSINESS`, and the source and target account groups must be of the same type.

  - `object.amount` (string, required)
    A positive cash amount, as a decimal string with up to two decimal places.

  - `object.currency` (string, required)
    Alphabetic three-letter [ISO 4217](https://www.iso.org/iso-4217-currency-codes.html) currency code.
* EUR — Euro.
* GBP — Pound Sterling.
    Enum: "EUR", "GBP"

  - `object.status` (string, required)
    Status of the cash balance transfer.
* ISSUED - Transfer has been created and the cash movement is in progress.
* CONFIRMED - Cash was successfully moved from the source to the target account group.
* CANCELLED - Transfer was cancelled and no cash was moved.
    Enum: "ISSUED", "CONFIRMED", "CANCELLED"

  - `object.cancellation_reason` (string)
    Reason the transfer was cancelled. Present only when `status` is `CANCELLED`, otherwise `null`.

  - `webhook_id` (string, required)
    Webhook unique identifier.

## Response 200:

  - `200` (unknown)
    Request has been processed successfully.