What is a virtual account event?

Whenever a deposit is received, Bridge generates a VirtualAccountEvent with a unique id. You can:
  • Fetch historical events using the Virtual Account Activity API.
  • Receive real-time webhook notifications when:
    • A new deposit is received.
    • The status of an event changes (e.g. funds delivered, refund issued).
Each VirtualAccountEvent includes detailed information about the deposit, source, status, and destination.

Event Types

Below are the different types of virtual account events you may receive. You can identify the type of each event by checking the type field in the virtual account event object.
TypeDescription
funds_receivedBridge received funds via ACH or wire.
payment_submittedBridge submitted the crypto payment.
payment_processedPayment confirmed on-chain. Final state.
funds_scheduled(ACH only) Incoming funds are in transit with estimated arrival date.
in_reviewTransaction is under manual review.
refundedFunds could not be delivered and were refunded to the sender.
account_updateVirtual Account was updated (e.g. new destination address).
deactivationVirtual Account was deactivated.
reactivationVirtual Account was reactivated.
microdepositMicrodeposit verification detected. Funds are never onramped.
Deposit ID

All transaction-triggered events include a deposit_id field. This id is unique for each transaction that Bridge receives through this Virtual Account and can be used to link separate events to the same source transaction.

Event Breakdown