Getting Started with Trinsic

Step 0: Get Dashboard Access

To use Trinsic, you must be invited to your organization's account.

Click here to sign in: dashboard.trinsic.id

• If your organization already has a Trinsic account, reach out to your organization admin and ask them to invite you.
• If you’re not sure or need help getting access, contact us at [email protected] and we’ll help you get set up.

Once you can sign in successfully, you’re ready to continue.

Step 1: Understand Test vs Live Environments

Trinsic has two environments: Test and Live. API keys are scoped to environments, and each environment is used for different stages of development and rollout.

Test Environment: use it to explore Trinsic and build your integration safely.

• Includes Trinsic-hosted mock providers
• Supports sandbox testing for providers with test mode
• Uses fake credentials
• No per-transaction costs
• Best for development, experimentation, and automated testing

Live Environment: use it for real provider workflows, including demos and production.

• Supports real identity providers
• Can be used to demo real providers with real users, run limited pilot tests, and launch full production traffic
• Uses real credentials
• Verifications using a Production profile in Live are billable. Verifications using a Demo profile in Live are not billed.

Step 2: Get Your API Key

Your API key authenticates requests from your application to Trinsic. To generate your first key:

1. Sign in to the Trinsic Dashboard
2. Switch to the Test environment using the environment switcher in the bottom-left
3. Navigate to the Developer tab.
4. Copy your Test API Key.
5. Store it securely, you’ll use it to authenticate all API requests

Step 3: Create a Relying Party for Your Company

A relying party is the company or brand your users are verifying with. For most teams, that’s your own company. It’s the home base for your identity verification setup. It holds:

• Branding: the name, logo, and colors your users see during verification.
• Domains: the domains your verification flows run on.
• Provider registrations: the details some ID providers require before you can accept their credentials.

Set it up once and every verification profile you create can reuse it. For example, you might want one profile for age verification and one for full identity verification. Each new profile picks up your branding and activated providers automatically. You don’t have to set anything up twice.

To create your relying party:

1. Go to the Relying Parties tab in the Dashboard and click Create Relying Party.
2. Name it after your company.
3. Select your domains (verify.trinsic.id is the default option), or request a new one if you want a custom domain.
4. Set your branding: logo and colors.
5. Request at least one provider and complete its registration form. The form will include any information needed for Trinsic to register you with the provider. Registration is required for your branding/domain to appear in production.
6. Publish the relying party.

Step 4: Create a Verification Profile

Every verification in Trinsic runs through a verification profile. Your relying party says who is asking. A profile defines a specific use case: which providers are enabled, where data is stored, and how it’s handled.

With your relying party in place, creating a profile takes a minute:

1. Go to Verification Profiles and click Create Verification Profile.
2. Name your profile. This is internal only, so pick something that describes the use case.
3. Choose a profile type, Demo or Production. Demo verifications in Live are not billed. Production is for true end user traffic.
4. Select the relying party you just created.
5. Choose your geography, US or EU. This decides where verification data is stored and which domain the profile uses. US is the default.
6. Review your settings and publish the profile.
7. Copy the Verification Profile ID from the profile details page. You’ll need it when calling the API.

To change what users see, edit the relying party, not the profile. The change applies to every profile that uses it.

Once your profile is created, you’re ready to test a verification and start integrating.

Step 5: Perform a test verification in the Dashboard

The quickest way to check your verification profile’s setup and explore the verification experience is to launch a verification from the Dashboard.

1. On the details page for your verification profile, scroll down to the Providers table.
2. Find the provider you want to test. We recommend the Mock - Redirect provider.
3. Under Actions, click Launch.
4. Complete the verification in the popup that opens.
5. Once you’re done, click View Session Results in your main browser window.

💡 If the verification shows Trinsic’s branding instead of yours, that provider isn’t ready for your relying party yet. Your setup is still working.

Step 6: Integrate

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

• An organization
• An API key
• A relying party for your company
• A configured verification profile with a corresponding verificationProfileId