| Camera not starting | Ensure you are accessing the page over HTTPS (or localhost). Camera API requires a secure context |
| Camera permission denied | The SDK reports { status: "camera_permission_denied" } on onUpdate (not onFailure) and hides on-camera controls. Customize copy with cameraPermissionDeniedMessage, or set showCameraPermissionDeniedMessage: false and render your own screen |
| "Failed to initialize Lens" error | Verify your Client ID is correct and that Lens For Browser is enabled for your account |
| Black screen after initialization | Check browser console for errors. Ensure camera permissions are granted. Try a different browser |
| SDK import errors in Next.js | Use dynamic import: const VeryfiLens = (await import('veryfi-lens-wasm')).default inside useEffect or event handler |
| Spinner stays on screen | Check browser console for WASM loading errors. Ensure your network allows connections to lens.veryfi.com |
| Document not detected | Ensure adequate lighting and contrast between the document and the background surface |