Skip to main content
Event type: customer.status.updated Sent when a customer’s verification or status changes. See Webhooks overview for delivery, headers, and signature verification.

data fields

customerId
string
The customer identifier.
change
object
{
  "type": "customer.status.updated",
  "timestamp": "2026-06-23T12:00:00.000Z",
  "data": {
    "customerId": "cus_3ddd0e5b-6276-4b48-b756-c1fcc9a2efd1",
    "change": {
      "kind": "kyc",
      "status": "approved",
      "statusUpdatedAt": "2026-06-23T12:00:00.000Z"
    }
  }
}