KYC Renewal Deadline Exceeded Webhook

IDWise sends this webhook when a user fails to complete a KYC renewal within the configured deadline. After a Verification Update Required webhook with trigger KYC Renewal is sent and the user does not resubmit the required steps before the deadline expires, this webhook fires to notify your system that the renewal window has closed.

Use this webhook to take action on expired renewals, for example, restricting account access, flagging the user for compliance review, or triggering an internal workflow.

Webhook Trigger

When the KYC renewal deadline passes without the user completing the required steps, IDWise sends an HTTP POST request to your configured webhook URL with the following JSON payload:

{
  "event": "KYC Renewal Deadline Exceeded",
  "body": {
    "eventId": "4****-****-****-*********7",
    "journeyId": "6720***********22e",
    "referenceNo": "840...........23",
    "requiredSteps": [
      {
        "stepId": "<STEP_ID>",
				"renewalDeadline": "2025-09-15T00:00:00Z",
      }
    ]
  }
}

📘
The payload structure may be extended in the future. Ensure your webhook handler can safely ignore unknown fields to maintain forward compatibility.

Payload Fields

Top-Level Fields

Field	Type	Description
`event`	string	Always set to `"KYC Renewal Deadline Exceeded"` for this webhook.
`body`	object	Contains the journey details and expired renewal information. See below.

Body Fields

Field	Type	Description
`eventId`	string	Unique identifier for the webhook event. Remains the same across retries to help you avoid duplicate processing.
`journeyId`	string	Unique ID for the verification journey that required renewal.
`referenceNo`	string	Your internal reference number for the journey.
`requiredSteps`	array	List of steps the user was required to resubmit but did not complete before the deadline. See Required Steps below.

Required Steps

Each item in the requiredSteps array identifies a step that was not resubmitted before the deadline:

Field	Type	Description
`stepId`	string	ID of the step that required resubmission.
`renewalDeadline`	string	ISO 8601 UTC timestamp of the renewal deadline for this step.

Recommended Actions

When you receive this webhook, consider the following actions based on your compliance requirements:

Action	Description
Restrict account access	Temporarily limit the user's access until they complete the renewal.
Send a reminder	Notify the user that their verification has expired and prompt them to complete the renewal.
Log the event	Record the deadline expiration for audit trail and regulatory reporting purposes.

Configuring Webhooks

To receive this webhook, configure your webhook endpoint in the IDWise Dashboard. For setup instructions, see Configure Webhook URLs.