Business Personnel Authentication

These webhook events specifically track facial biometric authentication statuses of associated personnel (e.g., ultimate beneficial owners, authorized signatories) within business entities.

🔔 Event Types

Event IdentifierTrigger Condition & Business MeaningActionable Advice
entity.person.biometric.successAuthentication Successful: Triggered when personnel within business entities successfully complete facial recognition authentication.Update trusted status of specific personnel within system.
entity.person.biometric.requestAuthentication Rejected: Triggered when personnel facial authentication results are rejected by system due to non-compliance.No special integration required. System automatically resets status. Simply guide customers to restart authentication process.

📦 Payload Example

When events occur, DogPay sends POST requests to configured webhook endpoints. Below is complete payload example of entity.person.biometric.success event:

{
    "event_id": "8cf4c4b2-2345-5678-90bc-def012345678",
    "event_identifier": "entity.person.biometric.success",
    "data": {
        "personId": "9ae7f40a-e91a-4576-a428-c7332a85ff72"
    }
}