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 camerasimulate only works with sandbox keys. Live keys reject it with invalid_request.
| To test | Do this |
|---|---|
| A pass | simulate: "pass", finish the scan |
| A fail | simulate: "fail", finish the scan |
| Someone giving up | Close the pop-up. The browser gets cancelled and the session stays open until it expires |
| An expired link | Create a session and wait 10 minutes before opening it |
| Your webhook | Use 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.