Notifications

AI Tools

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

Node.js
Java
PHP
Python
C#
JSON
    
​x
 
const notificationConfig = new NotificationConfigBuilder()    .withEndpoint('https://yourdomain.example/idverify/updates')    .withAuthTypeBasic()    //.withAuthTypeBearer()    .withAuthToken('username:password')    .forResourceUpdate()    .forTaskCompletion()    .forCheckCompletion()    .forSessionCompletion()    .withTopic('client_session_token_deleted')    .build();​const sessionSpec = new SessionSpecificationBuilder()    // ...    .withNotifications(notificationConfig)    // ...    .build();
Copy

Below are the different updates and options Yoti can provide:

Notification	Description
withEndpoint	Endpoint 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.
withAuthToken	Allows 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'
withAuthTypeBasic	You 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.
withAuthTypeBearer	This allows use of the bearer token standard, the system will create the header as follows, using the entry from withAuthToken: Authorization: Bearer
forResourceUpdate	Update received whenever there are changes to resources in the session. For example, a user uploading a new document.
forTaskCompletion	Sent 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.
forSessionCompletion	Triggered when all tasks and all checks inside of a given session have been completed.
forCheckCompletion	Sent when a check completes – for example a document authenticity check being performed.
withTopic('client_session_token_deleted')	Sent when the user has completed the client flow. This will trigger some of the backend checks to run.

See below for example notification payloads.

Example response

Schema
    
 
{    // Always provided    "session_id": "<uuid>",    "topic": "string",    // Optional and present only when "topic" is "task_completion"    "task_id": "<uuid>",    // Optional and present only when "topic" is "resource_update"    "resource_id": "<uuid>",    // Optional and present only when "topic" is "check_completion"    "check_id": "<uuid>"}
Copy

Session Completion
Check Completion
Client Session Completion
Task Completion
Resource Update
    
 
{    "session_id": "04f3b176-dcb8-428e-9b8e-8c8cd0915158",    "topic": "session_completion"}
Copy

Last updated on

Was this page helpful?