Known issues
-
CSP blocks SDK loading — without the required CSP directives (
worker-src,script-src, etc.), the Web SDK fails to load Web Workers and additional resources. Review the CSP configuration. -
prepareSelfieCameraForIFrameoutside an iFrame returns error73724— the iFrame method only works inside an iFrame. UseprepareSelfieCamerafor non-iFrame contexts. The reverse is also true. -
Fullscreen on iPhone is restricted — Apple restricts the use of full-screen APIs specifically on iPhones (iPads are acceptable). For captures on iPhones, manually configure the positioning of the iFrame.
-
Frame is distorted by parent CSS — design systems with grid components (Bootstrap, Material-UI, etc.) can interfere with the capture frame. Position the frame (
id="box-camera") where it does not inherit unwanted CSS rules. -
Smart camera fails on Web Mobile when frame is not 100vw/100vh — for mobile, the capture frame must occupy 100% of the device screen to avoid issues with computer vision algorithms.
-
Liveness with interaction does not work in social media webviews — Liveness without interaction is approved on Instagram and Facebook webviews; the interactive variant is not.