Skip to main content
A virtual bank account (VBA) transaction event is emitted whenever funds are received into a virtual bank account assigned to your account. Use it to reconcile incoming bank transfers in real time, matching each credit to the payer via its statement descriptor and recording the amount against your account. 
{
  "eventId": "whe_fooD944t4VUKkaDT",
  "eventType": "virtual_bank_account.transaction",
  "eventTime": 1729608043615,
  "transactionId": "vbatxn_fooBOwYsaK50AEfK",
  "amount": 50000,
  "currency": "USD",
  "transactionTimeStamp": 1729608043615,
  "statementDescriptor": "ACME CORP INV 1042"
}
​
eventId
string
A unique identifier for this specific event. This ensures that each event can be tracked and processed individually.
​
eventType
string
Describes the type of event. In this case, it signifies that a transaction has been received into a virtual bank account.
​
eventTime
integer
The timestamp when the event was generated, typically in milliseconds since the Unix epoch (January 1, 1970). This value can be used to track when the event occurred.
​
transactionId
string
A unique identifier for the specific virtual bank account transaction. This ID ties the event back to the individual credit received into the account.
​
amount
integer
The amount received, expressed in the smallest unit of the currency. Here, 50000 represents 500.00 USD (because USD uses two decimal places).
​
currency
string
The currency of the transaction, as a three-letter ISO 4217 code (e.g. USD).
​
transactionTimeStamp
integer
The timestamp when the underlying bank transaction occurred, in milliseconds since the Unix epoch. This reflects when the funds were credited to the account, which may differ from eventTime.
​
statementDescriptor
string
The descriptor that appeared on the bank statement for this credit. Use it to identify the payer or reconcile the transfer against an invoice.