> ## Documentation Index
> Fetch the complete documentation index at: https://developer.hellgate.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Event notification

> The platform delivers events to your registered webhook endpoint using a shared envelope:
`id`, `created_at`, `type`, `reason`, and a `related_object` you can fetch for the detail.

The `type` field identifies the event. The events documented here are the Account
Information Service's `ais.*` events, sent when an account-check session reaches a terminal
state:

- On `ais.completed`, `related_object` references the account information record — fetch it
  with **Get account information**.
- On a failure event, `related_object` references the session.

Every delivery is signed with `x-hmac-signature` (HMAC-SHA256 over the raw body, keyed by
your `signing_secret`); verify it before trusting the payload.



## OpenAPI

````yaml /platform/services/account-information/openapi.yaml webhook eventNotification
openapi: 3.1.0
info:
  title: Account Information API
  description: >-
    Verify a shopper's bank account — ownership, holder name, and account
    identifiers — through the Hellgate Cloud Platform Account Information
    Service. Create a session, drive the shopper through the bank login with the
    Web SDK, and receive the verified record on your backend.
  version: '1.0'
  contact:
    name: Starfish GmbH & Co. KG
    email: hello@starfish.team
    url: https://hellgate.io
  license:
    name: Hellgate API Terms
    url: https://hellgate.io/terms-and-conditions
servers:
  - url: https://api.eu1.hellgate.cloud
    description: EU1 environment
security:
  - bearerAuth: []
tags:
  - name: Account Information
    description: Create account-check sessions and retrieve the verified record.
  - name: Webhooks
    description: Register an endpoint and receive account-check event notifications.
paths: {}
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: >-
        An Account Information–scoped OAuth2 access token obtained from the
        platform Authentication API. Send it as a bearer token on every request.

````