CustomerStatusChanged

Description

A webhook event is sent when a client's status changes. This event includes both the customer's overall lifecycle status and their specific verification status.

Payload Example

{
  "eventId": "d1d3ff91-8aba-403c-930c-3dea9863b56a",
  "eventType": "CustomerStatusChanged",
  "eventTimestamp": "2025-08-29T17:16:11Z",
  "customerId": "7a941c46-d6fa-47b7-999b-2d318e8d926a",
  "customerExternalId": "abc123",
  "customerStatus": "Active",
  "customerVerificationStatus": "Verified"
}

Field Descriptions

Field	Type	Description
`eventId`	string (UUID)	Unique identifier for the webhook event.
`eventType`	string	The type of event, always `CustomerStatusChanged` 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.
`customerStatus`	string	The new status of the customer (e.g., `Active`, `Blocked`, `Closed`). See Status Models.
`customerVerificationStatus`	string	The specific verification status (e.g., `Verified`, `Rejected`). See Status Models.