Age Verification Status Description
| Status | Description |
|---|---|
| Undefined | The status is returned if it is an initial API/SDK run. |
| Pending | The Age Verification (or Identity Verification in case of “Ask My Parent”) was started by a user, but hasn’t been completed (offline waiting); In case of Ask My Parent, it could mean a child user waits for approval from a parent user. |
| Confirmed | The status is returned if a user age is verified or if parent user verifies age for a child user. |
| Declined | The status is returned if a user age is determined to be a minor (in case of Unico verification) or if a child user is declined by a parent. |
| Canceled | The status is returned in case a user closes down the Age Verification widget until the next time the widget is opened. |
| Inconclusive | The status is returned when a user verification cannot be determined to be either confirmed or declined. Service can decide to either re-run the user through the verification or treat as declined |
| Error | This status is returned when a verification attempt that is stuck in the “Pending” state has expired or there has been a user side network error. Error relates to the fact that the reason for the state expiring is unknown to our back end. |
Status Action Matrix
| Status | run() | Definition | Action |
|---|---|---|---|
Undefined | No | The SDK is idle. No action has been taken for this userIdentifier yet. | Call run() |
Undefined | Yes | Edge Case / Error: The app tried to start the SDK, but it failed to register (e.g., network drop, script error). | Re-run SDK. |
Pending | Yes | The SDK is actively processing the flow for this user. | Poll getStatus(). Show a loading/processing UI. |
Pending | No | User previously ran SDK but hasn’t finished the process. | Call run(). |
Cancelled | Yes | The process was aborted mid-flight (e.g., user closed a modal, session timed out). | Stop polling. Show a “cancelled” message and offer a button to Re-run SDK. |
Inconclusive | Yes | Terminal State. The response is not able to be determined to pass or fail. | Service can decide to either re-run SDK or treat result as a fail. |
Confirmed | Yes | Terminal State. The process finished successfully. | Stop polling. Display success result and move the user to the next step of your app flow. |
Declined | Yes | Terminal State. The process finished, but the user/action was rejected. | Stop polling. Display declined result/error and handle the rejection gracefully. |
Error | Yes | A pending request has expired or a user network error has occurred. | Re-run SDK. |