Skip to main content
Payout webhooks notify your system about lifecycle changes of an outgoing payment initiated from a wallet. A payout represents any movement of funds leaving a wallet, whether sent to a bank account or a blockchain address. These events allow you to track execution status, update balances, notify users, and reconcile outgoing transactions in your accounting systems. Only payouts with status COMPLETED represent successfully executed fund transfers.

​
Payout Events

Events represent lifecycle transitions of a payout. A payout follows this state flow:
  • PROCESSING — The payout has been created and is being processed.
  • COMPLETED — Funds have been successfully sent.

​
Available events

​
Payout types

A payout can be executed through different payment rails depending on configuration. The payoutType field in the webhook payload identifies which rail was used.

​
Amount behavior (Important)

For payouts, the amounts object describes the full flow of funds: Notes:
  • Do not assume that debitedAmount.currency matches creditedAmount.currency. Always rely on the explicit currency fields provided in the payload.
  • fees, amountAfterFees, fx and creditedAmount are only included when applicable to the payout (no fees, same-currency payouts, etc.).
  • All monetary amounts are expressed in minor units (e.g. cents).