Getting Started

📘

Test vs Live Environments

Trinsic offers two different environments: Test and Live. API Keys are scoped to environments.

The Test environment provides access to a number of Trinsic-hosted "mock" Providers, as well as the ability to perform test verifications with the many Providers within Trinsic's network which support a test mode. Verifications are performed with fake credentials, and do not incur a per-transaction cost.

The Live environment is suited for production use-cases. All Identity Providers within Trinsic's network are available for use in this environment. Verifications are performed using real credentials, and incur a per-transaction cost.

Use the Test environment to explore and experiment with Trinsic.

Get Your API Key

Before you can get started with identity acceptance in your application, you must first sign up on the Trinsic Dashboard and fetch your environment-specific API Key.

1. Visit dashboard.trinsic.id.
2. Sign in to your account using your business email.
   1. If you're not already onboarded, you can sign up yourself or schedule an onboarding call here.
3. Ensure you're on the Test environment by using the environment switcher in the bottom left.
4. Go to the Developers page and click to copy your API Key for the Test environment.
5. Save your API Key somewhere secure; you will need it to make API calls.

Create a Verification Profile

Next, create a Verification Profile in the Test environment. All verifications are tied to individual Verification Profiles; think of them as bundles of configuration for a set of Providers, typically tied to a specific use-case.

1. Visit the Verification Profiles page
2. Click Create Verification Profile
3. Configure the general settings for your Verification Profile
   1. Profile alias: An internal name to help keep track of your Verification Profiles.
   2. Domain: The domain name to use for interstitial redirects and Trinsic-hosted UIs.
      1. Leave this as-is
   3. Redaction period: The amount of time data from a verification will be stored in Trinsic's servers
   4. Zero access encryption: Whether zero access encryption is enabled for this Verification Profile
      1. Click Here to learn more about this feature
   5. Branding: The user-facing brand name, primary color, and logo shown to users in Trinsic's hosted UIs and in Identity Providers' applications.
4. Click Next: Configure Providers
5. Select the Providers you wish to enable for this Verification Profile.
   1. This can be changed after creation.
   2. We recommend selecting, at the very least, the Mock - Redirect Provider. This provides the simplest and most straightforward testing experience.
6. Click Add Providers at the bottom to finalize the creation of your Verification Profile.
7. On the details page for your new Verification Profile, copy its ID. This can be found near the top.
   1. You will need this when making API calls.

Perform a test verification in the Dashboard

The quickest way to validate your Verification Profile's configuration and explore the verification experience is to launch a verification via the Dashboard.

1. On the details page for your Verification Profile, scroll down to the Verification Profile Providers table.
2. Find the Provider for which you wish to launch a test verification.
   1. We recommend the Mock - Redirect Provider.
3. Under the Actions column, click the three dots, then Launch Verification.
4. Complete the verification in the newly-opened popup.
5. Once done performing the verification, click View Session Results in your main browser window.

Integrate

Congratulations! You now have everything you need to begin integrating Trinsic's SDK:

• An Organization
• An API Key
• A configured Verification Profile with a corresponding verificationProfileId

Next, follow the Integration Guide to begin performing verifications in your own application.