Skip to main content
A verification that reaches a final status reports it in two fields.
  • status is completed or failed.
    • completed: the provider finished the check, with or without user data.
    • failed: the verification stopped before the provider finished the check.
  • result.code is what you branch on. The codes are the same for every connection.
result.message is a short description of the code, for developers. Do not branch on it or show it to users. Write the text your users see from result.code. To update an integration that reads status alone, see Migrate to Result Codes.

Codes

More codes can be added. Only RECEIVED gives user data, so treat a code you do not know as not verified and offer the user another method. Support is at support@hopae.com.
SESSION_EXPIRED is the provider’s own time limit. A verification past its expiresAt is deleted and returns 404 instead. See Expiry.

Where the code appears

Userinfo is available only when the code is RECEIVED. Any other code answers 409 SESSION_INVALID_STATUS_TRANSITION.