Implementation Guide

This guide provides step-by-step instructions to integrate Prove Verified Users℠. There are separate guides for both server-side and client-side implementations available. Prove provides server SDKs in the following languages: Java, TypeScript/JavaScript, and Go. If you are using a different backend language, you can easily interact with the REST APIs.

In order to integrate Verified Users with possession, use one of the client-side SDKs.

Prove Sandbox Credentials

Before you begin implementing, ensure you have Prove Sandbox credentials from the Developer Portal. To access Sandbox credentials, follow the steps outlined on the Authentication and Testing page.

Implementation

These instructions assume you are using the server-side SDK. If you are using the REST APIs instead, you can easily call the respective endpoints.

Step	Client-Side	Server-Side
Verify
1	If you need to collect the consumers phone number, first name, or last name, create a screen to prompt them for this information.
2	On submit, the form calls an endpoint on your backend server to pass in the consumer-submitted data. It also passes in the `possessionType` of either `mobile` or `desktop`.
3		Setup the SDK with the OAuth client ID and client secret from Portal to handle authentication for all server-side calls. If you are calling the APIs directly, you will need to make a call to the /token endpoint in order to generate the OAuth token.
4		Call the server-side SDK Verify() function to pass in the data to start the session. The call will return a one-time use `authToken` and a `correlationId`.
5		Save the `correlationId` in your session (you’ll use it in the Verify Status call for the same consumer session) and then return the `authToken` to your client-side.
6	Setup the authenticator and the associated functions for Instant Link, one-time password (OTP), and Auth Finish Step. The Auth Finish step calls to your backend server which then calls the server-side SDK Verify-Status() function.
7	Pass the `authToken` to the client-side SDK Authenticate() function. Once the client-side possession work is complete, the Auth Finish step will execute.
Verify-Status
8		Call the server-side SDK Verify-Status() function to return the results of the verification. The Verify-Status response will return `true` or `false` indicating whether the name claimed by an individual is the one who owns the phone number. If the API returns `success=false`, then run your exception process.

Step	Server-Side
Verify
1	Pass in the consumers first name, last name, phone number, and optional customer identifier.
2	The Verify response will return `true` or `false` indicating whether the name claimed by an individual is the one who owns the phone number. If the API returns `success=false`, then run your exception process.

Test Your Prove Implementation

Once your implementation is complete, follow the Sandbox test scenarios with each of the Sandbox test users to ensure both success and failure states are working properly.

Launch Steps

Please reference the Production Launch Steps to request your Production credentials.

Prove Pre-Fill®

Prove Identity

Prove Verified Users℠

Implementation Guide

Prove Sandbox Credentials

Implementation

Test Your Prove Implementation

Prove Pre-Fill®

Prove Identity

Prove Verified Users℠

​Prove Sandbox Credentials

​Implementation

​Test Your Prove Implementation

Prove Sandbox Credentials

Implementation

Test Your Prove Implementation