Verification flow

Overview

A verification goes through several states from creation to completion.

CREATED

Verification created via POST /verifications/. The user has not yet opened the verification link.

STARTED

The user has started the verification process — actively engaging with the flow.

USER_DATA_COLLECTED

All data required by the requirements has been collected and is now being processed by the pawaPass system.

REVIEW (optional)

Manual action is required. A pawaPass agent reviews the verification when automated checks are inconclusive.

Final status

The verification resolves to one of three final states (see below).

Identity verified. Document data extracted.

Failed face scan attempts or agent decision.

Session expired. Default: 7 days.

Successful verification (auto-approved)

CREATED → STARTED → USER_DATA_COLLECTED → APPROVEDThe most common flow. User completes all steps, system auto-approves.

Manual review then declined

CREATED → STARTED → USER_DATA_COLLECTED → REVIEW → DECLINEDAutomated checks are inconclusive, agent reviews and declines.

User never starts

CREATED → EXPIREDUser doesn’t open the verification link within the expiration window.