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 Session | Hosted Provider Session | Advanced 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 collection | Redirect back returns resultsAccessKey, or iFrame/popup send message. | Redirect back returns resultsAccessKey | Redirect 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.
Updated 8 days ago