Working with the Sandbox — FrankieOne

The sandbox environment is your safe space to test and validate API integrations before going live. All operations performed here are isolated from production data.

Accessing the Sandbox

Request Access

Contact our sales team to get sandbox access as part of the onboarding process.

Receive Credentials

You’ll get a welcome pack containing:

API access keys
Code examples
Test data sets

Additional Services (Optional)

Let us know if you need access to:

Portal services
IDV (Identity Verification) services

Testing Guidelines

Test Data Matching Rules

Special Test Cases

Available Entity Profiles

Entity profiles determine the combination of checks performed during verification. Choose based on your regulatory requirements and jurisdiction.

Basic Profiles

Safe Harbor Profiles

KYB Profiles

International Profiles

Profile	Check Types	Description
`default`	`two_plus,id,pep_media,idvalidate`	Standard verification suite
`gov_id`	`blacklist,id_only,pep,idvalidate`	Government ID focused checks
`gov_id_media`	`blacklist,id_only,pep_media,idvalidate`	Enhanced government ID checks with media screening

Profile Selection

KYC profiles are designed for individual verification
KYB profiles are specifically for business-related verifications
Safe Harbor Plus profiles are required for jurisdictions with mandatory address verification (e.g., New Zealand)

Testing Error Scenarios

Credit Header Failures

Set street address to either:

“Equifax"
"Experian”

This forces a credit header failure for the specified bureau.

Non-ID Check Failures

Set middle name to “FailNonID” to:

Force fail all non-ID checks
Only evaluate ID verification

Ensure ID-related details (name, DoB, ID numbers) are correct for proper testing.

Data Source Note

All data sources in the sandbox environment are stubbed and may return randomized source information for testing purposes.