Entity Status

🔔 Event Types

Event Identifier	Trigger Condition & Business Meaning	Actionable Advice
`entity.status.update`	Status Updated: Triggered whenever there is progression or change in entity verification status, including completion of biometric authentication for related persons in business contexts.	🌟 Workflow Trigger: Listen to this event. Check `kycStatus` and `canApplyVa` fields within payload to determine whether to proceed with Virtual Account applications or core operational workflows.

📦 Payload Example

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

{
    "event_id": "7bf3b3a1-1234-4567-89ab-cdef01234567",
    "event_identifier": "entity.status.update",
    "data": {
        "id": "a7b04434-449a-45af-953a-aaf5a0c206d9",
        "type": "person",
        "kycStatus": "completed",
        "canApplyVa": true,
        "identifierId": "3125385178",
        "legalName": "John Doe",
        "legalNameEn": "John Doe",
        "createdAt": "2025-12-13 03:02:58",
        "status": "active",
        "callId": "303dbdb5-25b1-46d0-ac09-a548d627425b"
    }
}

{
  "id": "a7b04434-449a-45af-953a-aaf5a0c206d9",
  "type": "person",
  "kycStatus": "completed",
  "canApplyVa": true,
  "identifierId": "3125385178",
  "legalName": "John Doe",
  "legalNameEn": "John Doe",
  "createdAt": "2025-12-13 03:02:58",
  "status": "active",
  "callId": "303dbdb5-25b1-46d0-ac09-a548d627425b"
}