Fiat deposit updated

Event type: payin.updated

payin.updated is the fiat-deposit successor to the deprecated balance.updated event. During the migration, both names are delivered for the same deposit — payin.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 fiat-deposit handling at payin.updated before then.

Fiat deposits, settled either over a bank rail (a transfer into a virtual account) or through a payment code (PIX in Brazil, QR in Bolivia). Both arrive as payin.updated, but the data fields differ between the two — each field below states when it is present. For on-chain crypto deposits, see Crypto 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.

string

Deprecated alias of id, carrying the same value. Sent for bank-rail deposits only, and only during the transition.

string

Your company identifier.

string

Your external reference, if one was provided.

string | null

The state the deposit moved from. For payment-code deposits it carries the previous state, and is null only on the first event. For bank-rail deposits it is always null: a single deposit still produces several events as it progresses, but each one is reported on its own, so rely on state rather than on the transition.

string

The current deposit state.

number

The deposit amount, in minor units.

string

The currency of amount. For payment-code deposits this is the local currency the payer paid in (BOB, BRL) — the USDC you receive is reported separately in creditedUsdc.

string

The payment rail: pix or bo_qr_code. Payment-code deposits only.

number | null

The USDC amount credited to your balance once the deposit settles; null before then. Payment-code deposits only.

string

The settlement rail. Bank-rail deposits only.

string | null

Not set for fiat deposits. Bank-rail deposits only.

string | null

Failure reason, when applicable.

string

ISO 8601 timestamp of the update.

{
  "type": "payin.updated",
  "timestamp": "2026-06-23T12:00:00.000Z",
  "data": {
    "eventId": "payin:ext-009:funds_received",
    "id": "dep_9f86d081884c7d65",
    "payoutId": "dep_9f86d081884c7d65",
    "companyId": "cmp_123",
    "externalId": "ext-009",
    "previousState": null,
    "state": "funds_received",
    "amount": 100000,
    "currency": "usdc",
    "blockchain": "ach",
    "txHash": null,
    "errorReason": null,
    "updatedAt": "2026-06-23T12:00:00.000Z"
  }
}

{
  "type": "payin.updated",
  "timestamp": "2026-07-27T17:08:00.000Z",
  "data": {
    "eventId": "payin:payin_889af3c5-96cf-4c38-a4b7-ede7438528d2:payment_processed",
    "id": "payin_889af3c5-96cf-4c38-a4b7-ede7438528d2",
    "companyId": "cmp_123",
    "externalId": "ext-042",
    "previousState": "awaiting_funds",
    "state": "payment_processed",
    "amount": 10000,
    "currency": "BOB",
    "creditedUsdc": 14.32,
    "method": "bo_qr_code",
    "errorReason": null,
    "updatedAt": "2026-07-27T17:08:00.000Z"
  }
}

API Documentation

Guides

Balances

Quotes

Payouts

Payins

Checkout

Cards

Webhooks

Fiat deposit updated

`data` fields

​data fields

`data` fields