Skip to main content

Error Handling

A good integration distinguishes between transport issues, user cancellations, and verification failures.

Common Failure Areas​

  • session token fetch failed
  • mobile handoff did not complete
  • polling timed out
  • result submission failed
  • backend rejected the final token
  • show clear UI states for pending, success, and failure
  • log backend verification failures with operation context
  • avoid treating timeouts as successful biometric completion