Redirect URL for Automatic age assurance flows
/age-gate/check now accepts a redirect URL that k-ID navigates to once an Automatic age assurance challenge completes. This is intended for top-level browser handoffs (such as a mobile webview that bounces out to k-ID and back) where an iframe-based result handler isn't an option.
What's new
options.playerAgeAssurance.redirectUrl. Pass anhttp(s)URL or a custom-scheme mobile deeplink (for examplemyapp://age-gate/return) on/age-gate/check. After the player completes or dismisses theCHALLENGE_AGE_GATE_AGE_ASSURANCEflow, k-ID redirects to that URL withchallengeId,productId,sessionId(onPASS), andstatus(PASSorFAIL) appended as query parameters. Existing query parameters on the URL are preserved.- Scope. The option is only honored for
CHALLENGE_AGE_GATE_AGE_ASSURANCE.CHALLENGE_PARENTAL_CONSENTis unaffected and continues to return through the trusted-adult flow. - Confirm outcomes server-side. The redirect query parameters are a UX hint. Treat the
Challenge.StateChangewebhook or/challenge/get-statusas the source of truth before granting access.