Bearer Token Integration Guide

Upon application registration, you will immediately have access to the application details page which will list the client_id and client_secret needed to configure your OAuth client.

Overview

ID.me White Label Verification uses Bearer Token Authorization to provide authorized access to its API. Requests to retrieve user data require an bearer_token that is used to authorize access to ID.me's REST API. This token is unique to a partner and should be stored securely. Contact partnersupport@id.me to generate a bearer token.

Environments

ID.me provides two separate environments for integration. Both will be set up for you as needed and credentials provided to you.


Enviorment Domain Description
Sandbox https://services.idmelabs.com Sandbox was designed for for development, connectivity and user-acceptance testing. With test credentials you can use this end point to test various scenarios. Please note that test credentials are separate from our production environment and can only be used within Sandbox.
Production https://services.id.me Used for production-level integration. Only real credentials can be used (no test credentials). Credentials separate from sandbox environment.

Authentication

API authentication works using a shared secret key thats generated using a strong cryptographic algorithm. Please make sure this key is kept safe. To successfully authenticate, the shared secret needs to be Base64 encoded and passed as an "Authorization" header, along with the "ID.me" prefix:


Bearer Token Example
Authorization: ID.me MThjYmRhNjgtZjJiNi00ZTU5LTgyYzYtNjY0OWIyOWU1ZDVj\n

Group Affiliation Verification

Using ID.me's verification technology, partners may leverage digital identity and target the following affinity groups with special benefits or offers.


Group Credential Name
Military Troop ID
Students Student ID
First Responders Responder ID
Teachers Teacher ID
Government Government ID
Employee Employee ID
Alumni Alumni ID

Integration Options

ID.me's technology is designed to be flexible and scalable. Our partners are able to integrate ID.me anywhere to cater to their specific requirements and user experiences. Below you will find integration options that suit multiple user experiences, our In Cart/Checkout Full Integration being our most popular option.


In Cart/Checkout Full Integration In Cart/Checkout Hosted Solution Within Account SSO Landing Page In-Store
Seamless UX new_releases new_releases new_releases new_releases new_releases new_releases new_releases new_releases new_releases new_releases new_releases new_releases new_releases new_releases new_releases new_releases
Increased Loyalty/Repeat Purchases new_releases new_releases new_releases new_releases new_releases new_releases new_releases new_releases new_releases new_releases new_releases new_releases new_releases new_releases new_releases new_releases
Increased New-to-File Shoppers* new_releases new_releases new_releases new_releases new_releases new_releases new_releases new_releases new_releases new_releases new_releases new_releases new_releases
Increased Conversion Rates new_releases new_releases new_releases new_releases new_releases new_releases new_releases new_releases new_releases new_releases new_releases new_releases
Reduced Operational Costs Yes Yes** Yes Yes Yes Yes
Valuable Data for CRM and Retargeted Marketing Yes No Yes Yes Yes Yes
Time to Integrate 3 days < 1 day 3 days 3 days 3 days 3 days
Attracts ‘Pre-Verified’ Users Yes Yes Yes Yes Yes Yes
Prevents Duplicate Accounts Yes Yes Yes Yes Yes Yes
Can Prompt Re-Verification Yes Yes Yes Yes Yes Yes

new_releases new_releases new_releases = Large Impact

new_releases new_releases = Moderate Impact

new_releases = Small Impact

* This is also dependent on partner marketing of the program

** Getting started, In-cart hosted solution requires lowest level of effort

The integration options presented have been widely adopted. However, there are many different ways ID.me's technology can benefit your platform. If you have a unqiue user experience or use case, please Contact Us to discuss how ID.me can help improve your ablitiy to verify user affiliation.

In Cart/Checkout Full Integration

ID.me’s standard full integration offers a seamless user experience that allows customers to easily apply group discounts at checkout. Since customers are trained to look for and apply discounts at checkout, this integration has proven to reduce cart abandonment and increase conversion rates by up to 4X. It has also shown to encourage customer loyalty and repeat purchases.

Ua example 01

In Cart/Checkout Hosted Integration

This solution creates a similar user experience as a full cart integration, but takes only a few minutes to install. Requiring minimal setup and developer resources, the Hosted Solution reduces the operational costs to launch a discount program.

Lenovo example 01

Within Account

Verify the user’s identity during the initial account creation process or within their existing account settings. Once an identity is tied to an account, partners are empowered to personalize the user experience. ID.me ensures that a customer’s information is tied to only one account, eliminating the risk of the same information being used to create duplicate accounts.

Mlbtv example 01

Single Sign On (SSO)

ID.me’s Single Sign-On integration allows customers to use their ID.me account to instantly access exclusive benefits, promotions and services. Each Single-Sign On account receives a unique user ID, eliminating the risk of duplicate accounts. Due to ID.me’s network approach, millions of eligible customers arrive pre-verified with an existing ID.me account.

Tdc example 01

Landing Page

Partners can create a customized experience with the Landing Page integration. This option allows partners to limit the exposure of their discount program while increasing customer loyalty. ID.me also passes valuable customer data back to the partner, empowering marketers to segment audiences in their CRM and retarget customers.

Medievaltimes example 01

In-Store

ID.me’s In-Store capabilities create a seamless in-store experience that removes the burden of determining customer eligibility from store employees. Verifying customers in-store protects customer data, increases customer loyalty, and expands the partner’s knowledge of their customer base—all the while reducing operational costs.

Academy example 01

Sample User Flows

The typical flow begins at one of our partner websites, where an end user may see an ID.me verification button during registration or in the checkout flow.

Military

USAA

A very nice sentence.

USAA close
play_arrow Play Full Screen
Service Records

A very nice sentence.

Service Records close
play_arrow Play Full Screen
.mil Email

A very nice sentence.

.mil Email close
play_arrow Play Full Screen
Document Upload

A very nice sentence.

Document Upload close
play_arrow Play Full Screen

Student

Service Records

A very nice sentence.

Service Records close
play_arrow Play Full Screen
Document Upload

A very nice sentence.

Document Upload close
play_arrow Play Full Screen

Responder

EMT National

A very nice sentence.

EMT National close
EMT State

A very nice sentence.

EMT State close
play_arrow Play Full Screen
EMT Document Upload

A very nice sentence.

EMT Document Upload close
Firefighter Proboard

A very nice sentence.

Firefighter Proboard close
Firefighter Document Upload

A very nice sentence.

Firefighter Document Upload close
Police Document Upload

A very nice sentence.

Police Document Upload close
play_arrow Play Full Screen

Teacher

State Credentials

A very nice sentence.

State Credentials close
play_arrow Play Full Screen
Document Upload

A very nice sentence.

Document Upload close
play_arrow Play Full Screen