Bearer Token Integration Guide

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.

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.

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.

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.

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.

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

Military usaa
USAA close
featured_video Play Full Screen
Military scra
play_arrow Service Records
Service Records close
featured_video Play Full Screen
Military email
play_arrow .mil Email
.mil Email close
featured_video Play Full Screen
Military dd214 request
play_arrow DD214 Request
DD214 Request close
featured_video Play Full Screen
Military doc upload
play_arrow Document Upload
Document Upload close
featured_video Play Full Screen

Student

Student realtime
play_arrow Real Time
Real Time close
featured_video Play Full Screen
Student doc upload
play_arrow Document Upload
Document Upload close
featured_video Play Full Screen

Responder

Responder emt national
play_arrow EMT National
EMT National close
featured_video Play Full Screen
Responder emt state
play_arrow EMT State
EMT State close
featured_video Play Full Screen
Responder emt doc upload
play_arrow EMT Document Upload
EMT Document Upload close
featured_video Play Full Screen
Responder firefighter proboard
play_arrow Firefighter Proboard
Firefighter Proboard close
featured_video Play Full Screen
Responder firefighter doc upload
play_arrow Firefighter Document Upload
Firefighter Document Upload close
featured_video Play Full Screen
Responder police doc upload
play_arrow Police Document Upload
Police Document Upload close
featured_video Play Full Screen

Teacher

Teacher realtime
play_arrow State Credentials
State Credentials close
featured_video Play Full Screen
Teacher doc upload
play_arrow Document Upload
Document Upload close
featured_video Play Full Screen