Skip to Content
MYIDIIDocs

Testing in the sandbox

Try every outcome for free, with simulated results.

Sandbox keys (sk_test_) create sandbox sessions. They run a simulated scan, cost nothing, and never touch a real liveness engine. The camera is optional, so they also work in automated tests.

Choose the outcome

Pass simulate when you create the session:

await myidii.sessions.create({ simulate: "pass" }); // the default
await myidii.sessions.create({ simulate: "fail" }); // looks like a screen held up to the camera

simulate only works with sandbox keys. Live keys reject it with invalid_request.

To testDo this
A passsimulate: "pass", finish the scan
A failsimulate: "fail", finish the scan
Someone giving upClose the pop-up. The browser gets cancelled and the session stays open until it expires
An expired linkCreate a session and wait 10 minutes before opening it
Your webhookUse Send test on the endpoint in the dashboard

From the dashboard

Run a test check on the Verifications page does the scan on your own device, with the result you choose, and shows you the record your server would get.

Live, on yourself

Once you're live, Try it on yourself runs a real check from the dashboard. It costs the same as any live check.

On this page