Errors

Journey

If at some point during the OneID® journey any error occurs, the user will be redirected to the redirect_uri provided during authorization with three query parameters error , error_oneid and state .

As the OneID journey follows OIDC, you should handle the errors mentioned in the specification:

errorDescription
invalid_requestThe request is missing a required parameter, includes an invalid parameter value, includes a parameter more than once, or is otherwise malformed.
unauthorized_clientThe client is not authorized to request an authorization code using this method.
access_deniedThe resource owner or authorization server denied the request.
unsupported_response_typeThe authorization server does not support obtaining an authorization code using this method.
invalid_scopeThe requested scope is invalid, unknown, or malformed.
server_errorThe authorization server encountered an unexpected condition that prevented it from fulfilling the request.
temporarily_unavailableThe authorization server is currently unable to handle the request due to a temporary overloading or maintenance of the server.

The error_oneid parameter is complimentary to the error and aims to further define the error that has occurred.

errorerror_oneidDescription
access_deniedOneID.OIDC.Redirect.UserCancelledUser cancelled the journey.
access_deniedOneID.OIDC.Redirect.SpamGuardBlockedThe user has been temporarily blocked because too many requests were made.
access_deniedOneID.OIDC.Redirect.IDScanDocumentNotFoundNo documents were uploaded by the user.
access_deniedOneID.OIDC.Redirect.IDScanFlaggedAn issue has been flagged with the document scan process.

Data Service

Errors that can be returned from our data service APIs are document in the Data Service API ReferenceAPI.

Type to search, ESC to discard
Type to search, ESC to discard
Type to search, ESC to discard