Smart UI FAQ and Troubleshooting
This guide addresses common questions and issues developers encounter when implementing the Smart UI.
Critical Implementation Notes
Before implementing Smart UI, ensure you handle the completion events properly to avoid users getting stuck on the “sit tight” page.
Handling Completion Events
The Smart UI emits specific events when the flow completes:
FF_CHECK_RESULT
FF_EXTERNAL_IDV_CHECK_COMPLETED
If you don’t handle these events, users will see either:
- A “sit tight” page (for passed checks)
- An “Oh No” page (for failed checks)
Common Issues and Solutions
Character Encoding Issues
Smart UI requires UTF-8 encoding. Add this meta tag to your HTML header:
Browser Compatibility
Smart UI is compatible with all ES5-compliant browsers.
View full browser compatibility table
Google API Key Security
Device Support and Limitations
Current minimum viewport width: 320-330 pixels
Future updates will improve responsiveness for smaller devices.
Address Collection Logic
Users are only prompted for past addresses when their initial address doesn’t return results.
The address collection flow works as follows: