---
title: "Balance update"
method: POST
path: "balances#update"
tags: ["webhook-event", "balance"]
---

# Balance update

`POST balances#update` (webhook)

Triggered every time a multi-currency account is credited or debited.

* Event type: `balances#update`
* Profile level subscriptions: Supported
* Application level subscriptions: Supported

Events may not be delivered in the order they occurred. Use `data.occurred_at` to reconcile the order, and `data.step_id` to order events within a single transaction.
For tracking events related to a single transaction such as a cancelled card transaction, use `data.step_id` to reconcile the order.
See the [Event ordering guide](/guides/developer/webhooks/event-ordering) for details.

See the [Webhooks guide](/guides/developer/webhooks) for setup instructions, signature verification, and best practices.

## Headers

- `X-Signature-SHA256` string
- `X-Delivery-Id` string, uuid
- `X-Test-Notification` boolean

## Payload

- union
  - V40019
    - `schema_version` '4.0.0' — Version of the event schema. Determined by the `schema_version` on your [webhook subscription](/api-reference/webhook).
    - `subscription_id` string, uuid — ID of the webhook subscription that triggered this event.
    - `event_type` string — Event type identifier
    - `sent_at` string, date-time — Timestamp when the event was sent.
    - `data` object
      - `resource` object
        - `type` string — Resource type (always `balance-account`).
        - `id` integer — ID of the account.
        - `profile_id` integer — ID of the profile that owns the account.
      - `amount` number — Transaction amount
      - `balance_id` integer — ID of the balance credited or debited.
      - `channel_name` string — Transfer category
      - `currency` string — Currency code
      - `occurred_at` string, date-time — When the transaction occurred.
      - `post_transaction_balance_amount` number — Available balance after current transaction.
      - `step_id` integer — Unique identifier for tracking sequence of transaction events.
      - `transaction_type` string — Either credit or debit
      - `transfer_reference` string — ID of the transfer.
  - V300
    - `schema_version` '3.0.0' — Version of the event schema. Determined by the `schema_version` on your [webhook subscription](/api-reference/webhook).
    - `subscription_id` string, uuid — ID of the webhook subscription that triggered this event
    - `event_type` string — Event type identifier
    - `sent_at` string, date-time — Timestamp when the event was sent
    - `data` object
      - `resource` object
        - `type` string — Resource type (always balance-account)
        - `id` integer — ID of the account
        - `profile_id` integer — ID of the profile that owns the account
      - `amount` number — Transaction amount
      - `balance_id` integer — ID of the balance credited or debited
      - `channel_name` string — Transfer category
      - `currency` string — Currency code
      - `occurred_at` string, date-time — When the transaction occurred
      - `post_transaction_balance_amount` number — Available balance after current transaction
      - `step_id` integer — Unique identifier for tracking sequence of transaction events
      - `transaction_type` string — Either credit or debit
      - `transfer_reference` string — ID of the transfer
  - V220
    - `schema_version` '2.2.0' — Version of the event schema. Determined by the `schema_version` on your [webhook subscription](/api-reference/webhook).
    - `subscription_id` string, uuid — ID of the webhook subscription that triggered this event
    - `event_type` string — Event type identifier
    - `sent_at` string, date-time — Timestamp when the event was sent
    - `data` object
      - `resource` object
        - `type` string — Resource type (always balance-account)
        - `id` integer — ID of the account
        - `profile_id` integer — ID of the profile that owns the account
      - `transaction_type` string — Either credit or debit
      - `amount` number — Transaction amount
      - `balance_id` integer — ID of the balance credited or debited
      - `currency` string — Currency code
      - `occurred_at` string, date-time — When the transaction occurred
      - `transfer_reference` string — ID of the transfer
      - `channel_name` string — Transfer category
  - V2102
    - `schema_version` '2.1.0' — Version of the event schema. Determined by the `schema_version` on your [webhook subscription](/api-reference/webhook).
    - `subscription_id` string, uuid — ID of the webhook subscription that triggered this event
    - `event_type` string — Event type identifier
    - `sent_at` string, date-time — Timestamp when the event was sent
    - `data` object
      - `resource` object
        - `type` string — Resource type (always balance-account)
        - `id` integer — ID of the account
        - `profile_id` integer — ID of the profile that owns the account
      - `transaction_type` string — Either credit or debit
      - `amount` number — Transaction amount
      - `currency` string — Currency code
      - `occurred_at` string, date-time — When the transaction occurred
      - `transfer_reference` string — ID of the transfer
      - `channel_name` string — Transfer category

## Acknowledgement `200`

Return any `2xx` status to acknowledge receipt of the event.

- object
  - `status` string

---

[API](https://skmtc.net/wise/apis/platform-api.md) · [All operations](https://skmtc.net/wise/apis/platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/wise/platform-api/revisions/4907a1d269ab/schema)