Prove Pre-Fill Sandbox Testing
Learn more about simulating the Prove Pre-Fill flow using the Sandbox environment
Overview
When you interact with the Sandbox environment, you’ll be able use the test users to simulate different behaviors. Simulate the possession checks using the client-side SDK. The testing environment doesn’t send text messages or validate real customer information.
Prove Pre-Fill sandbox test users can only be used with Prove Pre-Fill project credentials. Attempting to use these test users with different project credentials will result in an unauthorized access error.
Unless specified below, you can introduce failures in the tests that would otherwise be successful:
-
If you call a step out of order, you will receive:
-
Status Code: HTTP 403
-
Response:
{"code":1003,"message":"step not allowed"}
-
-
If a required field is missing, you will receive:
-
Status Code: HTTP 400
-
Response:
{"code":1001,"message":"field 'flowType' is missing"}
-
Steps
Follow these steps for each of the tests:
-
For Start:
-
Send into request:
-
flowType
: use eithermobile
ordesktop
-
phoneNumber
-
finalTargetUrl
:https://www.prove.com
-
dob
orlast4SSN
-
-
Response returns:
-
authToken
-
correlationId
-
next = v3-validate
-
-
-
For Validate:
-
Send into request:
correlationId
-
Response returns:
-
success = true
-
challengeMissing = false
-
next = v3-challenge
orv3-complete
-
-
-
For Challenge, if the earlier Validate call returned:
next = v3-challenge
:-
Send into request:
-
correlationId
-
dob or last4SSN
-
-
Response returns:
-
success = true
-
Individual information
-
next = v3-complete
-
-
-
For Complete:
-
Send into request:
-
correlationId
-
Individual information
-
-
Response returns:
-
success = true
-
changeDetected
-
next = done
-
-
Short-Term Test User
Use this test user when performing initial testing with cURL or Postman. This test user skips the client-side SDK authentication to walk you through the sequence of API calls.
Phone Number | First Name | Last Name | Address | City | State | Zip | Date of Birth | Social Security Number | |
---|---|---|---|---|---|---|---|---|---|
2001001695 | Milo | Pinson | 6377 Birchwood Hill | Littleton | CO | 80161-2001 | 1/17/1981 | 847350596 | mpinsonm@dyndns.org |
After initial short-term testing, implement the client-side SDK and use the remaining test users to test your implementation. Refer to the Quick Start Guide to gather required components.
Prove Pre-Fill Test Users
Use the following list of Prove Pre-Fill Test Users. Follow the instructions in the Staging environment to test out your implementation to ensure it’s working. Refer to the Outcomes Table to review scenarios to test and interpretation of success and failed states.
When prompted for your one-time password (OTP) during mobile flow testing, you must use 1234
to simulate a successful OTP. Any other combination of numbers simulates a failure. Use Marcia Longo to test your OTP setup.
Phone Number | First Name | Last Name | Address | City | State | Zip | Date of Birth | Social Security Number | |
---|---|---|---|---|---|---|---|---|---|
2001001687 | Agretha | Chene | 4861 Jay Junction | Boston | MS | 02208 | 12/29/1994 | 369956933 | achenee@printfriendly.com |
2001001688 | Nevin | Chattey | 9398 Scott Plaza | Austin | TX | 78744 | 3/20/1980 | 542742985 | nchatteyf@techcrunch.com |
2001001693 | Marcia | Longo | 00 Mallard Park | New Orleans | LA | 70165 | 7/19/1982 | 470806227 | mlongok@amazonaws.com |
Prove Pre-Fill Outcomes and Test Scenarios
The following table provides Pre-Fill outcome possibilities including which sandbox users to test with and interpretations of each success and failed state in Production. The Prove Pre-Fill Test Users table has the comprehensive list of test users including mock data. When troubleshooting success=false
in the API response, refer to the following section.

API Response Troubleshooting Tips
Use the following table for help troubleshooting when success=false
in an API response. For Production, refer to the Pre-Fill Outcomes and Test Scenarios table.
Server Side Call | Possible Behaviors Resulting in success=false | Troubleshooting Tips |
---|---|---|
/start | Not Applicable | Error and Status Codes page for common 400 response errors |
/validate | PreFill Sandbox Users intended to fail: Agretha Chene, Nevin Chattey | Test Scenario Table for which test users fail each scenario |
/validate | Client Side SDK Authenticate() function wasn’t called.* * Required for all sandbox users except Milo Pinson. | Client Side SDK implementation guide |
/validate | Wrong OTP entered | Client Side SDK implementation guide |
/challenge | The phone number entered isn’t associated with the social security number (SSN) or date of birth entered. | Pre-Fill Test User Table for sandbox test user data |
/complete | First Name, Last Name, or SSN isn’t associated with the phone number entered. | Test Scenario Table for which test users fail each scenario |
If you receive 400 or 500 response errors when running these test scenarios, refer to the Error and Status Codes page.
If you still have issues, send your correlationId
from a failing request. Use either the Support button in the Portal or contact your account representative.
For Production access, contact your sales representative.