Payout updated

{
  "type": "payout.updated",
  "timestamp": "2026-06-23T12:00:00.000Z",
  "data": {
    "eventId": "payout:3ddd0e5b-6276-4b48-b756-c1fcc9a2efd1:payment_submitted:payment_processed",
    "payoutId": "3ddd0e5b-6276-4b48-b756-c1fcc9a2efd1",
    "companyId": "cmp_123",
    "externalId": "ext-001",
    "onBehalfOf": "user-123",
    "previousState": "payment_submitted",
    "state": "payment_processed",
    "amount": 100000,
    "currency": "cop",
    "destinationType": "bank",
    "txHash": "0xabc123",
    "extraData": {
      "finalAmount": "99950",
      "finalAmountCurrency": "cop",
      "uetr": "97ed4827-7b6f-4b1a-9b0e-2a1c3d4e5f60",
      "trackingNumber": "TRK-0001"
    },
    "createdAt": "2026-06-23T11:00:00.000Z",
    "updatedAt": "2026-06-23T12:00:00.000Z"
  }
}

Event type: payout.updated

payout.updated replaces the deprecated payout.update. During the migration, both names are delivered for the same transition — payout.updated (new) and payout.update (legacy) — so you can migrate without missing events. payout.update is deprecated and will be removed on 15 November 2026; switch your payout handling to payout.updated before then.

The event type is always payout.updated regardless of the transition — read data.state (and data.previousState) to know what happened. See Webhooks overview for delivery, headers, and signature verification.

`data` fields

string

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

string

The payout identifier.

string

Your company identifier.

string

Your external reference, if one was provided.

string

The end user/entity the payout was made for.

string | null

The state before this transition. null on the first event.

string

The current payout state. See the table below.

number

The payout amount, in minor units (e.g. cents).

string

The destination currency.

string

One of wallet, bank, or qr_code.

string

Present only when the payout failed.

string

On-chain transaction hash. Present for wallet and bank destinations.

object

Bank-rail metadata. Present only for destinationType = bank.

Show extraData

string

Final settled amount.

string

Currency of the settled amount.

string

SEPA/SWIFT unique end-to-end transaction reference.

string

Tracking number.

string

ISO 8601 creation timestamp.

string

ISO 8601 last-update timestamp.

Payout states (`data.state`)

State	Meaning
`created`	Payout created
`in_review`	In review (pre-partner)
`awaiting_funds`	Awaiting funds
`funds_received`	Funds received
`payment_submitted`	Submitted / in progress
`payment_processed`	Completed successfully
`undeliverable`	Undeliverable
`returned`	Returned
`refunded`	Refunded
`canceled`	Canceled
`error`	Error / failed

{
  "type": "payout.updated",
  "timestamp": "2026-06-23T12:00:00.000Z",
  "data": {
    "eventId": "payout:3ddd0e5b-6276-4b48-b756-c1fcc9a2efd1:payment_submitted:payment_processed",
    "payoutId": "3ddd0e5b-6276-4b48-b756-c1fcc9a2efd1",
    "companyId": "cmp_123",
    "externalId": "ext-001",
    "onBehalfOf": "user-123",
    "previousState": "payment_submitted",
    "state": "payment_processed",
    "amount": 100000,
    "currency": "cop",
    "destinationType": "bank",
    "txHash": "0xabc123",
    "extraData": {
      "finalAmount": "99950",
      "finalAmountCurrency": "cop",
      "uetr": "97ed4827-7b6f-4b1a-9b0e-2a1c3d4e5f60",
      "trackingNumber": "TRK-0001"
    },
    "createdAt": "2026-06-23T11:00:00.000Z",
    "updatedAt": "2026-06-23T12:00:00.000Z"
  }
}

API Documentation

Guides

Balances

Quotes

Payouts

Payins

Checkout

Cards

Webhooks

Payout updated

`data` fields

Payout states (`data.state`)

​data fields

​Payout states (data.state)

`data` fields

Payout states (`data.state`)