Prove Pre-Fill Implementation Guide

This guide provides instructions to integrate . Implementation guides for server-side and client-side SDKs are available. Prove provides server-side SDKs in the following languages: Go, Java, TypeScript, and JavaScript. If you use a different back end language, you can interact with the API endpoints.

To integrate Prove Pre-Fill solutions, you must use 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 With the Server-Side SDK

Step	Client-Side	Server-Side
Start
1	Create or update your first screen to prompt for phone number and challenge data.
2	On submit, the form calls an endpoint on your back end server to pass in the consumer-submitted data. It passes in the `flowType` 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 integrate without the server-side SDK, make a call to the `/token` endpoint to generate the OAuth token.
4		Call the server-side SDK `Start()` function to pass in the data to start the session. The call returns a one-time use `authToken` and a correlation ID.
5		Save the correlation ID in your 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 makes a call to your back end server which then calls the server-side SDK `Validate()` function.
7	Pass the `authToken` to the client-side SDK `Authenticate()` function. Once the client-side possession work finishes, the Auth Finish step completes.
Validate
8		Call the server-side SDK `Validate()` function to complete the possession and reputation checks. The Validate response returns both the phone number and the `next` field indicating which API to call next. If the API returns `success=false`, then run your exception process: Prove Pre-Fill handling If the API returns `success=true`: the `next` field returns `v3-challenge`.
Challenge
9		Call the server-side SDK `Challenge()` function. The API returns the success=true with the user information if Prove can authenticate the consumers identity information with enough trust and assurance. Return user data in a response to the client-side. Otherwise it returns `success=false` with no user information. Return no user data in a response to the client-side.
10	If consumer information returns from Challenge response, prefill the form with the information. Otherwise, prompt the consumer to input their information in the form.
11	On submit, the form calls an endpoint to your back end server to pass in the consumer information.
Complete
12		Call the server-side SDK `Complete()` function to pass in the data to verify the user information. If the API returns `success=true`, continue with the onboarding activity. If the API returns `success=false`, run your exception process: Prove Pre-Fill handling

Step	Client-Side	Server-Side
Start
1	Create or update your first screen to prompt the consumer to accept the terms and conditions to use Mobile Auth to verify a consumer.
2	On submit, the form calls an endpoint on your back end server to pass in the consumer-submitted data. It passes in the `flowType` 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 integrate without the server-side SDK, make a call to the `/token` endpoint to generate the OAuth token.
4		Call the server-side SDK `Start()` function to pass in the data to start the session. The call returns a one-time use `authToken` and a correlation ID.
5		Save the correlation ID in your 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 Instant Link function prompts for a phone number from the consumer and then return in the callback. The OTP functions prompt for the phone number and the OTP, and then return in the callbacks. The Auth Finish step makes a call to your back end server which then calls the server-side SDK `Validate()` function.
7	Pass the `authToken` to the client-side SDK `Authenticate()` function. Once the client-side possession work finishes, the Auth Finish step completes.
Validate
8		Call the server-side SDK `Validate()` function to complete the possession and reputation checks. The Validate response returns both the phone number and the `next` field indicating which API to call next. If the API returns `success=false`, then run your exception process: Prove Pre-Fill handling If the API returns `success=true`: the `next` field returns `v3-challenge`.
Challenge
9	Next, create a screen to prompt for the consumers challenge data
10		Call the server-side SDK `Challenge()` function. The API returns the success=true with the user information if Prove can authenticate the consumers identity information with enough trust and assurance. Return user data in a response to the client-side. Otherwise it returns `success=false` with no user information. Return no user data in a response to the client-side.
11	If consumer information returns from the Challenge response, prefill the form with the information. Otherwise, prompt the consumer to input their information in the form.
12	On submit, the form calls an endpoint to your back end server to pass in the consumer information.
Complete
13		Call the server-side SDK `Complete()` function to pass in the data to verify the user information. If the API returns success=true, continue with the onboarding activity. If the API returns `success=false`, run your exception process: Prove Pre-Fill handling

Test Your Prove Implementation

Next, reference the Sandbox test scenarios to test users and simulate different behaviors encountered in production.

Launch Steps

Reference the Production Launch Steps to request your production credentials.

Prove Pre-Fill®

Prove Identity

Prove Verified Users℠

Prove Pre-Fill Implementation Guide

Prove Sandbox Credentials

Implementation With the Server-Side SDK

Test Your Prove Implementation

Prove Pre-Fill®

Prove Identity

Prove Verified Users℠

​Prove Sandbox Credentials

​Implementation With the Server-Side SDK

​Test Your Prove Implementation

Prove Sandbox Credentials

Implementation With the Server-Side SDK

Test Your Prove Implementation