Onfido provides the Sandbox environment to create checks and test our APIs without affecting your production environment. The type of token you use will determine whether you use the sandbox or live environment.
While testing with a sandbox token, it's worth noting that:
- sandbox check data is not processed by Onfido services or third parties—this means that sandbox responses are faster than live responses
- sandbox check results are pre-determined
- sandbox applicants are isolated from the live environment (applicant notification emails still get sent out to sandbox applicants)
- you won't be charged for checks in sandbox
You can make all the same API requests in the sandbox API as in the live one. Sandbox results have the same result response structures as live requests. You will also be notified of check and report status changes via your registered webhooks.
To use the sandbox, you'll need to generate a sandbox API token in your Onfido Dashboard.
By default, sandbox API tokens start with api_sandbox... and live API tokens start with api_live... This might vary if you're using a different region environment.