VIRTUAL ACCOUNT Webhook

Virtual Account webhook example

The virtual account webhooks is only available for processes that follow this flow, and it will be triggered if applicable.

FOR US ONRAMP FLOW

• A customer’s bank may require them to complete microdeposit verification before allowing them to send funds to their Virtual Account. This process consists of the bank sending some small test transactions to the account then requesting the customer verify those amounts.

  • This process is typically required before a customer can send funds from their personal bank account. If your customer receives funds from businesses they may never encounter this process.

  • Microdeposit funds are never onramped.

  • Microdeposits are only supported for Virtual Account numbers.

referenceId: unique user ID(customerId) of a customer received from Create User (Get KYC URL)

Virtual Account Events

• MICRO_DEPOSIT_ALERT

MICRO_DEPOSIT_ALERT

{
  "status": "MICRO_DEPOSIT_ALERT",
  "metadata": {
    "eventId": 22,
    "eventCreatedAt": "2023-11-17T13:33:14.000Z"
    "microdeposit": {
      "2025-07-01": [
        {
          "amount": 0.02,
          "bankName": "JPMorgan Chase",
          "currency": "usd",
          "createdAt": "2025-07-01T15:53:05.236Z"
        },
        {
          "amount": 0.13,
          "bankName": "JPMorgan Chase",
          "currency": "usd",
          "createdAt": "2025-07-01T15:51:02.765Z"
        }
      ],
      "2025-07-08": [
        {
          "amount": 0.08,
          "bankName": "JPMorgan Chase",
          "currency": "usd",
          "createdAt": "2025-07-08T16:40:04.357Z"
        },
        {
          "amount": 0.32,
          "bankName": "JPMorgan Chase",
          "currency": "usd",
          "createdAt": "2025-07-08T16:40:03.485Z"
        }
      ]
    }
  },
  "eventType": "VIRTUAL_ACCOUNT",
  "referenceId": "xxswe3baH_123456"
}