Virtual Accounts

Events

1. virtual_account_status_updated

Triggered when the status of a virtual account changes.

Payload Example

{
  "virtualAccountId": "9bc86a06-8300-41c8-8cef-d2eaa852164f",
  "externalCustomerId": "external_customer_id_123",
  "status": "completed",
  "timestamp": 1678901234567
}

Payload Schema

FieldTypeDescription
virtualAccountIdstringUnique identifier (uuid) of the virtual account
externalCustomerIdstringExternal identifier of the customer
statusstringCurrent status of the virtual account (pending, completed, failed)
timestampintegerUnix timestamp (milliseconds) when the event was triggered

2. virtual_account_transaction_status_updated

Triggered when the status of a transaction within a virtual account changes.

Payload Example

{
  "virtualAccountId": "9bc86a06-8300-41c8-8cef-d2eaa852164f",
  "externalCustomerId": "external_customer_id_123",
  "transactionId": "7a2cbc6f-ddef-4071-9628-a6559cb4ad89",
  "status": "Completed",
  "timestamp": 1678901234567
}

Payload Schema

FieldTypeDescription
virtualAccountIdstringUnique identifier (uuid) of the virtual account
externalCustomerIdstringExternal identifier provided for the customer
transactionIdstringUnique identifier (uuid) of the transaction
statusstringCurrent status of the transaction (Pending, Completed, Failed)
timestampintegerUnix timestamp (milliseconds) when the event was triggered