Account Events

Account Creation Events

Event Key: va.create

Description: Triggered when a VA application is successfully registered in the system and submitted to the bank for processing.

JSON Payload Example:

{
  "vaId": "fa397f5b-0acd-45d2-af45-f0ab8b65ca94",
  "vaName": "test-with-balance-10",
  "currency": "USD",
  "status": "applying",
  "statusMessage": "",
  "available": "0.00",
  "createAt": "2025-12-13 03:15:45",
  "updateAt": "2025-12-13 03:15:45",
  "country": "PR",
  "bankName": "JP_MORGAN",
  "payeeType": "global_multi",
  "payeeCurrencies": ["USD"],
  "bankInfoList": []
}

Account Update Events

Event Key: va.update

Description: Critical Event. Triggered when the VA status changes to active. This notification contains the complete banking details (Account Number, Routing Number, etc.) in the bankInfoList. Use this information to allow users to fund their accounts.

JSON Payload Example:

{
  "vaId": "fa397f5b-0acd-45d2-af45-f0ab8b65ca94",
  "vaName": "test-with-balance-10",
  "currency": "USD",
  "status": "active",
  "statusMessage": "",
  "available": "0.00",
  "createAt": "2025-12-13 03:15:45",
  "updateAt": "2025-12-13 03:25:01",
  "bankInfoList": [
    {
      "accountName": "John Mock-Doe",
      "bankName": "JP Morgan Chase NA",
      "bankAccountNo": "40000007289",
      "routingType": "ach_routing_number",
      "routingNumber": "021000021",
      "bankAddress": {
        "line1": "New York NY, US",
        "country": "US"
      }
    }
  ]
}