Skip to main content

​
Single URL, Two Modes

iDenfy uses one base URL for both sandbox and production:
Your API key pair determines which mode you’re in — not the URL. Sandbox keys return test results, production keys trigger real verifications. Your code stays the same, only the keys change.
Since the URL is identical, you can switch between sandbox and production by swapping API keys in your environment variables — no code changes needed.

​
Sandbox

The sandbox lets you:
  • Test your integration end-to-end without real documents
  • Simulate different outcomes (approved, denied, suspected)
  • Validate webhook handling with predictable payloads
  • Test error scenarios and edge cases
See Testing & Sandbox for step-by-step instructions.

​
Switching to Production

1

Configure Production Webhooks

Set your production webhook URL in Dashboard → Settings.
2

Secure Your Integration

Implement callback signing and IP whitelisting.
3

Test All Flows

Verify all verification outcomes are handled correctly. See the go-live checklist.
4

Swap API Keys

Replace sandbox keys with production keys in your environment variables.

Related topics

Dummy ResultsTeam Member ManagementAML Dummy ResultsComplianceCollecting Multiple Identity Documents