Crypto deposit updated

{
  "type": "crypto_deposit.updated",
  "timestamp": "2026-06-23T12:00:00.000Z",
  "data": {
    "eventId": "crypto-deposit:dep_9f86d081884c7d65:none:pending",
    "payoutId": "dep_9f86d081884c7d65",
    "companyId": "cmp_123",
    "externalId": "ext-009",
    "previousState": null,
    "state": "pending",
    "amount": 100000,
    "currency": "usdc",
    "blockchain": "polygon",
    "txHash": "0xdef456",
    "errorReason": null,
    "updatedAt": "2026-06-23T12:00:00.000Z"
  }
}

{
  "type": "crypto_deposit.updated",
  "timestamp": "2026-06-23T12:05:00.000Z",
  "data": {
    "eventId": "crypto-deposit:dep_9f86d081884c7d65:confirmed:completed",
    "payoutId": "dep_9f86d081884c7d65",
    "companyId": "cmp_123",
    "externalId": "ext-009",
    "previousState": "confirmed",
    "state": "completed",
    "amount": 100000,
    "currency": "usdc",
    "blockchain": "polygon",
    "txHash": "0xdef456",
    "errorReason": null,
    "updatedAt": "2026-06-23T12:05:00.000Z"
  }
}

Event type: crypto_deposit.updated

crypto_deposit.updated is the on-chain successor to the deprecated balance.updated event. During the migration, both names are delivered for the same deposit — crypto_deposit.updated (new) and balance.updated (legacy) — so you can migrate without missing events. balance.updated is deprecated and will be removed on 15 November 2026; point your on-chain deposit handling at crypto_deposit.updated before then.

On-chain crypto deposits. For fiat (bank-rail) deposits, see Fiat deposit updated. See Webhooks overview for delivery, headers, and signature verification.

`data` fields

string

Stable identifier for this deposit event. The same value is sent on the legacy balance.updated during the transition — use it to deduplicate the two names.

string

The deposit identifier (named payoutId for transport consistency).

string

Your company identifier.

string

Your external reference, if one was provided.

string | null

The state the deposit moved from. An event is emitted only when the state actually changes, so the transition always carries meaning. null on the first event.

string

The current deposit state.

number

The deposit amount, in minor units.

string

The deposit currency (e.g. usdc).

string

The chain the deposit settled on (e.g. polygon, tron, stellar).

string | null

On-chain transaction hash, when available.

string | null

Failure reason, when applicable.

string

ISO 8601 last-update timestamp.

{
  "type": "crypto_deposit.updated",
  "timestamp": "2026-06-23T12:00:00.000Z",
  "data": {
    "eventId": "crypto-deposit:dep_9f86d081884c7d65:none:pending",
    "payoutId": "dep_9f86d081884c7d65",
    "companyId": "cmp_123",
    "externalId": "ext-009",
    "previousState": null,
    "state": "pending",
    "amount": 100000,
    "currency": "usdc",
    "blockchain": "polygon",
    "txHash": "0xdef456",
    "errorReason": null,
    "updatedAt": "2026-06-23T12:00:00.000Z"
  }
}

{
  "type": "crypto_deposit.updated",
  "timestamp": "2026-06-23T12:05:00.000Z",
  "data": {
    "eventId": "crypto-deposit:dep_9f86d081884c7d65:confirmed:completed",
    "payoutId": "dep_9f86d081884c7d65",
    "companyId": "cmp_123",
    "externalId": "ext-009",
    "previousState": "confirmed",
    "state": "completed",
    "amount": 100000,
    "currency": "usdc",
    "blockchain": "polygon",
    "txHash": "0xdef456",
    "errorReason": null,
    "updatedAt": "2026-06-23T12:05:00.000Z"
  }
}

API Documentation

Guides

Balances

Quotes

Payouts

Payins

Checkout

Cards

Webhooks

Crypto deposit updated

`data` fields

​data fields

`data` fields