Sandbox mode

Sandbox mode tests your integration without contacting live identity verification vendors or incurring their cost. It simulates creating real records; no live vendor is consulted.

Toggle between live and sandbox mode in the dashboard. Each mode has its own API keys, playbooks, and users. To run real KYC (Know Your Customer) and KYB (Know Your Business) verifications, contact Footprint to activate your account.

In live mode, users are generally unique by phone number. In sandbox mode, two users can share a phone number as long as their sandbox IDs differ, so you can create several test users with the same login credentials. To test a returning user logging back into your app, provide an existing user's login credentials and sandbox ID.

An existing user's sandbox ID is on their detail page in the dashboard.

When you test KYC and KYB in sandbox mode, Footprint doesn't contact live verification vendors. Instead, after onboarding onto the playbook, you choose how the verification step resolves:

• Emulate an outcome. Pick a mock outcome such as Success, Fail, Manual review, or Step up. Footprint applies it directly and short-circuits your playbook's rules, which suits landing a user in a specific state.
• Evaluate rules. Run your playbook's rules as normal against a set of mocked risk signals you select. Use this to test the rules themselves: the rules engine evaluates the mocked signals and produces the resulting outcome.

For example, emulate a manual review to land in that state directly, or evaluate rules with a watchlist hit raised to confirm your rules route the user the way you expect.

Receiving one-time passcodes (OTPs) on your own phone or email gets tedious while testing onboarding flows, so Footprint provides fixture phone numbers and emails for logging into sandbox users.

Fixture contact info is valid only in sandbox mode; don't use it in live mode.

• The Integration guide walks through the full integration, from API key to decision.