API Environments
bronID provides two API environments for development and production use.
Environment URLs
| Environment | Base URL | Description |
|---|---|---|
| Test | https://dev.bronid.com | Test environment for development and integration testing. Use test values to simulate different verification outcomes. |
| Production | https://api.bronid.com | Live environment for real verifications. Requires a production API subscription. |
Test environment
The test environment is designed for testing your integration before going live. Key features:
- Free to use - Test verifications are not billed
- Test values available to simulate different verification outcomes (see Test Values)
- No real identity checks are performed
- Same API structure as production
Important: Do not submit real customer data in the test environment. Use test values to simulate different verification outcomes. Test verifications are for testing purposes only.
Test Portal
Access your test account at preview.bronid.com to:
- Generate test API keys
- View test verifications
- Configure webhook URLs
- Manage your test settings
Test form URLs
When using the Forms API in the test environment, form URLs will use the test domain:
https://forms-preview.bronid.com/ekyc-start/{trace}
Production environment
The production environment performs real identity verification checks.
Billing: All verifications submitted to the production environment are billed according to your subscription plan. Make sure you have completed testing in the test environment before going live.
To use production:
- Create a production account at portal.bronid.com
- Subscribe to an API plan that matches your verification needs
- Generate production API keys in Settings > Developers > API keys
- Update your integration to use
https://api.bronid.com
Production form URLs
When using the Forms API in production, form URLs will use the production domain:
https://forms.bronid.com/ekyc-start/{trace}
Switching environments
When you're ready to go live:
- Update your API base URL from
https://dev.bronid.comtohttps://api.bronid.com - Replace test API credentials with production credentials
- Remove any test value logic from your integration
- Update webhook URLs in your production bronID Portal settings
API versioning
All v5 API endpoints follow the same URL structure:
{base_url}/v5/{endpoint}
For example:
- Test:
https://dev.bronid.com/v5/verifications - Production:
https://api.bronid.com/v5/verifications