Create a session

There are three steps to follow to integrate the In Branch API:

  1. Create the session
  2. Send instructions
  3. Generate results

Every time an end user elects to supply an ID document on the relying party app / website / custom product, you will need to create a session with Yoti to the initiate the session and perform ID checks.

HTTP
Copy
Good to know
It's worth reading our Identity Verification documentation to understand how we complete the Yoti document review process
Full JSON
Copy

IBV options property

ParmeterDescriptionMandatory
support

Each resource will be mapped to a list of allowed sources in the results

  • MANDATORY - Only a physical android device may create/upload Resources that satisfy this requirement IBV sources.
  • NOT_ALLOWED - The Resource may still be created either by a physical android device or by the end user at home.

Hint There are cost implications if you choose NOT_ALLOWED. Please contact your account manager for more details.

Notifications

For information on notifications please head over here. We have included two additional notifications

ParmeterDescription
NEW_PDF_SUPPLIEDWhen the user completes the prerequisite flow, they will have an option to download the PDF. You can subscribe to be notified when the user has done this.
INSTRUCTIONS_EMAIL_REQUESTEDIf you do not enable this notification an email will automatically be sent to the user with their instructions. If you do enable this notification the email service will be revoked and you will need to configure this set up yourself. Yoti will send an async notification to prompt you to retrieve the PDF from Yoti and send it to the customer.

Example response

If the request is successful and a session is generated the API will send a response in the form:

JSON
Copy
ResponseDescription
client_session_token_ttlTime in seconds until the client session expires
client_session_tokenUsed to authenticate the session
session_idID of the session
Type to search, ESC to discard
Type to search, ESC to discard
Type to search, ESC to discard
  Last updated by Jason Martyres