Skip to main content

Implementing Age Assurance

Age Verification Service 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
  • /age-verification/perform-age-appeal → Age Appeal (for suspected underage users)

Overview​

Here is how you can implement the entire end to end assurance flow.

Step I: When you call Access Age Verification API (/age-verification/perform-access-age-verification)

  • The end user sees 3 verification options (Face Scan, ID Scan and Parent Attestation).
  • When any Verification attempt is completed -> the appropriate result[PASS or FAIL] is sent back to you.
  • When a verification attempt CANNOT complete due to an error, the user will get to retry.
  • Every Verification method has a cap on the number of retries i.e. max attempt defined (currently default 3 for each method)
  • If the verification cannot complete i.e. all the number of retries on all the verification methods have exhausted -> the FAIL result is returned to the Integrator.

To summarize, result is returned only in 2 scenarios

  • When a verification attempt is complete [PASS or FAIL]
  • When the max number of retries have been exhausted for all methods. [FAIL]

Alternatively you can choose to use /age-verification/perform-facial-age-estimation to only offer facial age estimation as first step.

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

  • The end user sees 2 verification options (ID Scan and Parent Attestation).
  • When a Verification attempt is complete -> the appropriate result[PASS or FAIL] is sent back to the Integrator
  • When a verification attempt CANNOT complete due to an error, the user gets to retry.
  • Every Verification method has a cap on the number of retries i.e. max attempt defined (currently default 3 for all methods)
  • If the verification cannot complete i.e. all the number of retries on all the verification methods have exhausted -> the FAIL result is returned to the Integrator.

Step III: You received a FAIL result, so you can choose to give another attempt to the user to Age Appeal or you can choose to give “Contact Customer Support” as the final option to the user.

The Flow