CustomerPersonalBankAccountCreated

Description

A webhook event is sent when a personal bank account is successfully created for a client. For certain flows, this occurs automatically after the verification process is completed and the customer's identity is confirmed.

Payload Examples

UK Bank Account (Sort Code)

{
  "eventId": "d1d3ff91-8aba-403c-930c-3dea9863b56a",
  "eventType" : "CustomerPersonalBankAccountCreated",
  "eventTimestamp": "2025-08-29T17:16:11Z",
  "customerId": "7a94146-d6fa-47b7-999b-2d318e8d926a",
  "customerExternalId": "abc123",
  "currency": "GBP",
  "routingCodeType": "GBDSC",
  "routingCodeValue": "04-14-04",
  "accountNumber": "10938594",
  "recipientName": "John Smith"
}

EUR Bank Account (IBAN)

{
  "eventId": "d1d3ff91-8aba-403c-930c-3dea9863b56a",
  "eventType" : "CustomerPersonalBankAccountCreated",
  "eventTimestamp": "2025-08-29T17:16:11Z",
  "customerId": "7a94146-d6fa-47b7-999b-2d318e8d926a",
  "customerExternalId": "abc123",
  "currency": "EUR",
  "swift": "TCCLGB3L",
  "iban": "GB12TCCL12345610938594",
  "recipientName": "Adam-ac SumSubACSGBRRCGBR"
}

Field Descriptions

Field	Type	Description
`eventId`	string (UUID)	Unique identifier for the webhook event.
`eventType`	string	The type of event, always `CustomerPersonalBankAccountCreated` for this webhook.
`eventTimestamp`	string (ISO 8601)	The time when the event occurred.
`customerId`	string (UUID)	The unique identifier of the customer in the Altery system.
`customerExternalId`	string \| null	The optional customer identifier provided by you during creation.
`currency`	string	The ISO 4217 currency code for the bank account (e.g., `GBP`, `EUR`).
`recipientName`	string	The official name of the account holder.
`routingCodeType`	string \| null	The type of routing code, `GBDSC` for UK Sort Code.
`routingCodeValue`	string \| null	The 6-digit UK Sort Code.
`accountNumber`	string \| null	The 8-digit UK bank account number.
`swift`	string \| null	The BIC/SWIFT code of the bank.
`iban`	string \| null	The International Bank Account Number.