Integration Tips

Follow these tips to maximize user conversion rates:

  • Mobile Optimization: Have users complete Face Match on mobile. The Face Match UI is optimized for mobile phones (and works on every phone). If a user is on desktop, we recommend showing them a QR code to open and complete on mobile. Reach out if you need help with this.

  • Share Support Resources: Share Verisoul’s tips & tricks hub with users. If a user needs support, share Verisoul’s pre-built tips section to help them complete the verification quickly! Tips Link

  • Clear Communication: Tell the user what is happening. We recommend letting your users know why they will be verified with FaceMatch and the benefits to them. For example:

    • Let’s make sure you are real and help us distinguish between real users and fake ones. This check keeps [your application] safe and only takes 30 seconds to complete (no app download required)
  • Webview Integration: Run Face Match in a webview when integrating into a mobile app. Instead of having the user leave app and use native browser it is recommended to run Face Match in a webview within the app. For an example of this type of integration see the react-native sample app.

User Tips

How to Succeed

Users should follow these steps to maximize success rates:

  • Find Good Lighting: The user should find a light source and try to maximize light on their face, while avoiding light sources behind them (which create shadow).

  • Follow On-screen Instructions: The UI will tell users when to move closer or further.

  • Turn Up Device Brightness: The UI will turn white on the liveness check screen, so a bright screen will help illuminate their face.

Common Failures

  • Camera Issues:

    • User camera feed is being used by another app (we will detect a potential security risk)
    • User doesn’t allow camera permissions
    • User camera is blurry or lighting is bad
  • Device Orientation: User device is in landscape mode (needs to be in portrait - if a mobile device)

  • Session Expiration: User session is expired - they received a session from your app, but waited too long to start / complete the session.