Skip to main content
Transaction events track the lifecycle of a deposit or withdrawal. Subscribe to them to reconcile funding and settlement in your own system.

​
Populated fields

Each transaction event populates transactionId and accountId. The provider field indicates the source of the change (for example byzantine, bridge, or onchain).

​
Event types

EventFires when
transaction.createdA transaction has been created.
transaction.waiting_for_fundsByzantine is waiting for incoming funds.
transaction.payment_in_reviewThe payment is under review.
transaction.funds_in_transferFunds are being transferred.
transaction.funds_receivedFunds have been received.
transaction.processingThe transaction is being processed on-chain.
transaction.completedThe transaction completed successfully.
transaction.simulation_failedThe transaction simulation failed.
transaction.revertedThe transaction was reverted.
For status meanings and polling as an alternative to webhooks, see Tracking Transactions.

​
Example payload

{
  "id": "00000000-0000-4000-8000-000000000001",
  "eventType": "transaction.completed",
  "occurredAt": "2026-06-03T15:00:00Z",
  "livemode": true,
  "payloadVersion": 1,
  "integratorId": "8f7064b4-9587-496f-a5cc-00fbf5af01d5",
  "transactionId": "53f2d2dc-6abc-40fa-b2d2-d6d76b839c09",
  "accountId": "b3f2d2dc-6abc-40fa-b2d2-d6d76b839c09",
  "provider": "byzantine",
  "data": {
    "status": "completed"
  }
}