Crime Check Service Workflow

The Crime Check service works asynchronously. When a check request is submitted, the service immediately returns a requestId. Once the report is generated, the service sends the report to a configured callback URL.

There are two ways the service can be triggered depending on the portal being used.


1. HR Portal Workflow (Automatic)

In the HR portal, the crime check service runs automatically in the background after the HR user enters the required check information.

  1. HR user enters the required check information.
  2. The system automatically calls the Crime Check API in the background.
  3. The API returns a requestId.
  4. The system stores this requestId for tracking the request.
  5. Once the report is ready, the Crime Check service sends the result to the configured callback URL.
  6. The callback handler save report and mark complete the check according to risk level.

2. Admin Portal Workflow (Manual)

In the Admin portal, the workflow is the same as the HR portal, except the service must be triggered manually by clicking Run Service button.

Manual Report Fetch (Fallback)

If the callback request fails or the system does not receive the report, the administrator can manually fetch the report using the requestId from the Admin portal.

  1. Admin triggers a Fetch Report action.
  2. The system calls the Crime Check API to retrieve the report.
  3. Save report and mark complete the check according to risk level