Choose which age fields each verification result channel returns
A product can now choose which age fields k-ID returns in a verification result, separately for get-status, webhooks, and the JavaScript result. Verification results can also carry an ageBand that names the product's own age group for the verified age.
What's new
- Age result setting in Compliance Studio. On the Product access tab, the Age result card has a Date of birth, Age, and Age category toggle for each channel. A channel returns a field only when its setting includes it. A saved change takes effect after you publish the product. Until you save a setting, the product follows your organization's settings.
includeDobprecedence on get-status. When the product has a saved Age result setting, an explicitincludeDob=trueorincludeDob=falseonGET /age-verification/get-statusoverrides the Get status Date of birth toggle.ageBandon verification results. When a result includesageCategoryand the verified age falls in one of the product's age bands for the jurisdiction, the result also includesageBandwithkey,name,lowerAge, and an optionalupperAge. Set bands in the Age bands card. Only Indonesia has default bands from k-ID.
Compatibility
A PASS result can now arrive without age or ageCategory, depending on the product's Age result setting for that channel. If your code reads these fields without checking that they are present, add a guard. ageBand is additive. Use ageCategory for access decisions, not ageBand.