Skip to main content
Event type: balance.updated Covers both fiat deposits (bank rail) and on-chain crypto deposits — tell them apart with the blockchain field (bridge for fiat, or the chain name such as polygon, tron, stellar for crypto). See Webhooks overview for delivery, headers, and signature verification.

​
data fields

​
payoutId
string
The deposit identifier (named payoutId for transport consistency).
​
companyId
string
Your company identifier.
​
externalId
string
Your external reference, if one was provided.
​
previousState
null
Always null for deposit events.
​
state
string
The current deposit state.
​
amount
number
The deposit amount, in minor units.
​
currency
string
The deposit currency (e.g. usdc).
​
blockchain
string
bridge for fiat deposits, or the chain name (e.g. polygon, tron, stellar) for on-chain crypto deposits.
​
txHash
string | null
On-chain transaction hash, when available.
​
errorReason
string | null
Failure reason, when applicable.
​
updatedAt
string
ISO 8601 last-update timestamp.
{
  "type": "balance.updated",
  "timestamp": "2026-06-23T12:00:00.000Z",
  "data": {
    "payoutId": "dep_9f86d081884c7d65",
    "companyId": "cmp_123",
    "externalId": "ext-009",
    "previousState": null,
    "state": "funds_received",
    "amount": 100000,
    "currency": "usdc",
    "blockchain": "polygon",
    "txHash": "0xdef456",
    "errorReason": null,
    "updatedAt": "2026-06-23T12:00:00.000Z"
  }
}