Account Event

Account Event

Guru Pay sends an Account Webhook when an account changes state in the system. This allows your application to listent to account events like when a new account is created or closed.

Virtual IBANs

Currently Guru Pay application will send account events only to customers who are using Virtual IBAN product.

With the later system updates, after public communication account webhooks will be enabled for all customers.

When It's Triggered

This webhook is triggered when:

  • A new Virtual IBAN is opened for a customer

  • Virtual IBAN is closed

  • The webhook configuration is active for the recipient account.

Event Structure

{
  "type": "account",
  "event": "account.created",
  "created_at": 1757604022,
  "account": {
    "uuid": "7c004b54-3f62-4cb0-8ee1-16fc436ba39d",
    "status": "created",
    "customer_uuid": "6fe8a48e-82a1-4410-a18f-b2686b77f6d7",
    "account_name": "Account name",
    "account_number": "LT383400015000111111",
    "currency": "EUR",
    "opening_date": "2025-09-11",
    "opening_date_unix": 1757548800,
    "balance": 0,
    "balance_national": 0,
    "book_balance": 0,
    "book_balance_national": 0,
    "available_balance": 0,
    "available_balance_national": 0,
    "hold": 0,
    "cards_reserved_amount": 0,
    "cards_reserved_amount_national": 0,
    "created_at": 1757604019,
    "updated_at": 1757604019,
    "account_type": "virtual",
    "virtual_account_holder": {
      "name": "Virtual IBAN holder name",
      "person_type": "natural|legal",
      "citizenship": "LT",
      "registrationCode": "12345",
      "address": {
        "line": "Address line",
        "city": "Vilnius",
        "country": "LT",
        "postalCode": "111222"
      }
    }
  }
}

Event Types

Type
Description

account.created

New account was created and IBAN assigned

account.closed

Account was closed

Last updated

Was this helpful?