Skip to main content
Getting set up in Sandbox has two parts: install the sandbox World ID app on your test device, and point your integration at the Sandbox environment. Both are covered below. New here? Start with What is Sandbox? for context.

​
1. Install the sandbox World ID app

The sandbox apps are not publicly listed in the App Store or on Google Play. You install them through the testing links below.

​
iOS — TestFlight

  1. Install TestFlight from the App Store if you don’t have it.
  2. Open the public TestFlight link to join the external tester group: testflight.apple.com/join/VZEurhHe
  3. Install the World ID (Sandbox) build from TestFlight.
No App Store Connect account or per-email invite is required — the public link admits you to the external tester group directly.

​
Android — Google Play

The sandbox build is distributed through a private testing track on Google Play.

​
Request tester access

  1. In the Developer Portal, select World ID Sandbox from the sidebar.
  2. Enter the email address for the Google Account you use with the Google Play Store, then request tester access.
  3. Wait until access is granted before opening the Google Play testing link.

​
Install the build

  1. On your Android device, open the Google Play Store and confirm that it is signed in with the exact Google Account for which you requested tester access.
  2. If this is the account’s first Google Play Store sign-in, complete the initial setup and accept all Google Play Terms of Service before continuing.
  3. In the browser that will open the testing link, sign in to the same Google Account. The browser and Google Play Store must use the same account; otherwise, Google Play may report that the build is unavailable.
  4. Return to World ID Sandbox in the Developer Portal. On your Android device, scan the QR code or open the Google Play testing link.
  5. Install the World ID (Sandbox) build from Google Play.

​
Troubleshooting FAQ

  • Confirm that the email used to request tester access matches the Google Account used by both the browser and Google Play Store.
  • If the account has just signed in to Google Play for the first time, Google may need time to recognize the new account. Wait at least 15 minutes before opening the testing link again.

​
2. Point your integration at Sandbox

  1. Update IDKit to the latest version.
  2. Set environment: sandbox in your IDKit configuration.
Nothing else is required — the handoff will open the sandbox World ID app and return a proof to your session over the bridge.

​
Things to know

  • Sandbox apps aren’t publicly listed in the app stores. Testers install via TestFlight (iOS) or a private Google Play testing link (Android). Because access is gated to testers, install links and store acquisition can behave differently from a public production listing.
  • Proofs are non-production. Identities and proofs issued in Sandbox are for integration validation only.
  • Accounts are resettable. You can delete and recreate accounts freely while testing.

​
Next step

Once you’re installed and pointed at Sandbox, you’re ready to run the Selfie Check integration flows. See Testing Selfie Check in Sandbox for coverage, critical user journeys, and known limitations.