Integration Guide

Session Launch Modes

There are three possible session modes to select from, depending on how much of Trinsic's Hosted UI you want to use in your solution.


Our full hosted UI solution. The Trinsic-hosted widget manages the entire user experience, including guiding the user through method selection, handover to mobile device, etc. Capture results via the resultsAccessKey sent back to you via redirect url or the Trinsic Web SDK.

The middle ground between a Widget Session and an Advanced Provider Session. Your application guides the user through method selection, invoking Trinsic's hosted UI to handle complex integrations if necessary, and capturing results through the resultsAccessKey sent back to you via the redirect url.

Our "full white-label mode". Your application owns the entire user experience, falling back to Trinsic's hosted UI only if your application cannot support required functionality for a given provider.

Comparison

Widget SessionHosted Provider SessionAdvanced Provider Session
Trinsic Provider Selector
Launch individual provider✅ Only option✅ Only option
Trinsic UI✅ Only option✅ Only for providers that require additional user interaction🔵 Optionally, only for providers that require additional user interaction or completely white labeled
Block Trinsic UI🔵 Optionally enforce we never show our UI
Result collectionRedirect back returns resultsAccessKey, or iFrame/popup send message.Redirect back returns resultsAccessKeyRedirect back returns resultsAccessKeyor polling after session creation.

Test ID Provider

You can choose to enable a test ID provider (by default enabled) for easy testing. It will allow you to quickly go through an identity validation without needing to use an actual digital ID. The Test ID Provider is only meant to be used for demonstrations, development, and testing and will be disabled when the "Enable all integrations" button is toggled, as that is intended for production deployments.


SDKs

You can find all our SDKs including samples on our Github. We've included working samples for all SDKs that require only your auth token to run. If your specific tech stack isn't covered, please let us know; we're happy to help you get started. Click each link to find a detailed readme on the SDK's specific usage.


What's Next

Now check out our API Reference starting with the overview below: