Skip to main content

Implementing Age Assurance

Age Verification currently includes following APIs

  • /age-verification/perform-facial-age-estimation → Facial Age Estimation Only
  • /age-verification/perform-id-verification → ID Verification Only
  • /age-verification/perform-access-age-verification → Age assurance to determine whether a new user should have access to an App or content within the App
  • /age-verification/perform-age-appeal → A user suspected of being underage is attempting to get back into the application after being banned by the publisher for being under age, or failing an age check.

Overview​

Here is how you can implement the entire end to end Age Assurance flow in your application in a compliant way.

Step I: Call Access Age Verification API (/age-verification/perform-access-age-verification)

  • The end user sees all 3 verification options (Face Scan, ID Scan and Parent Attestation).
  • When any verification attempt is completed, the appropriate result [PASS or FAIL] is sent via the k-ID wehbook to your application.
  • When a verification attempt does not complete due to a problem with the verification itself (e.g. room too dark, face not in the camera, invalid ID card), the user will be allowed to retry.
  • Every verification method has an configured maximum number of retries i.e. max attempt defined (currently default 3 for each method).
  • If the user performs the maximum number of configured retries for all verification methods, the FAIL result is returned via the k-ID wehbook.

Therefore, a result is returned only in 2 scenarios

  • When a verification attempt is complete the result will be PASS or FAIL with a failureReason of age-criteria-not-met, verification-failed, or verification-error
  • When the max number of retries have been exhausted for all verification methods, the result will be FAIL with a failureReason of max-attempts-exceeded

Alternatively you can choose a single verification method to use as a first step. For example, you could use /age-verification/perform-facial-age-estimation to only offer facial age estimation, and fall back to other methods.

Step II: When and if you receive the result as FAIL, you can choose to allow the user to retry by appealing the result they obtained. To do this call the the Age Appeal API (/age-verification/perform-age-appeal)

  • The end user sees 2 verification options (ID Scan and Parent Attestation), since the burden of proof is higher when the user has already failed, or has been previously banned from the App.
  • When a verification attempt is complete -> the appropriate result[PASS or FAIL] is sent back via the k-ID webhook.
  • When a verification attempt does not complete due to a problem with the verification itself (e.g. invalid ID card), the user will be allowed to retry.
  • Every verification method has an configured maximum number of retries i.e. max attempt defined (currently default 3 for each method).
  • If the user performs the maximum number of configured retries for all verification methods, the FAIL result is returned via the k-ID wehbook.

Step III: You received a FAIL result, so you can choose to give another attempt to the user to appeal or you can choose to allow the user other means to gain access, for example, by contacting customer support.

The Flow