Notifications

The Identity verification service optionally posts an update notification, based on the selected subscription topics.

Javascript
Java
PHP
Python
C#
JSON
Copy

Below are the different updates and options Yoti can provide:

NotificationDescription
withEndpointEndpoint for notifications to be sent to. Only HTTPS endpoints with TLS 1.2 are supported. A POST message will be sent. Exposing this endpoint is not mandatory but highly recommended as it would avoid a continuous polling on the session retrieval endpoint.
withAuthTokenAllows the relying business backend to define an authorisation token, if they have secured API endpoints, allowing Yoti to call endpoints. We recommend protecting any exposed routes with basic authorisation. This should be used in conjunction with either 'withAuthTypeBasic' or 'withAuthTypeBearer'
withAuthTypeBasicYou may specify a basic auth token to the Identity verification API to be used when sending notifications to your endpoint. Credentials are automatically encoded as base64 and sent in the Authorisation header. For example "auth_token": "username:password" would result in Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ= being sent into the request header from Yoti.
withAuthTypeBearerThis allows use of the bearer token standard, the system will create the header as follows, using the entry from withAuthToken: Authorization: Bearer
forResourceUpdateUpdate received whenever there are changes to resources in the session. For example, a user uploading a new document.
forTaskCompletionSent when a task is completed. If you require TEXT_EXTRACTION and the check has been fulfilled, Yoti will send this through as an update to your endpoint.
forSessionCompletionTriggered when all tasks and all checks inside of a given session have been completed.
forCheckCompletionSent when a check completes – for example a document authenticity check being performed.

See below for example notification payloads.

Example response

Schema
Copy
Session Completion
Check Completion
Client Session Completion
Task Completion
Resource Update
Copy
Type to search, ESC to discard
Type to search, ESC to discard
Type to search, ESC to discard