Testing in Sandbox Mode
GuideHow to use simulated test credentials, trigger test webhook events, and test error scenarios in the Sandbox environment.
The SyncNexa Sandbox environment is an exact duplicate of production that operates on mock cryptographic data, allowing you to test every edge case without affecting real student records or incurring billing charges.
The Sandbox Environment
All requests made with API keys prefixed with sk_test_ operate in the Sandbox environment automatically.
Simulated Student Personas
| Test SyncTag / Input | Simulated Persona | Outcome / Response |
|---|---|---|
TEST_PASS_ACTIVE | Active Full-Time Student at University of Cambridge | completed (Pass) with valid 2026/2027 enrollment proof |
TEST_FAIL_EXPIRED | Former Student with Expired Enrollment | failed with ERR_EXPIRED_CREDENTIAL |
TEST_FAIL_REVOKED | Revoked Student Credential | failed with ERR_REVOKED_CREDENTIAL |
TEST_TIMEOUT | Unresponsive Session | Waits 30s and transitions to expired |
Simulating Webhook Events
You can test webhook delivery directly from the Business Portal dashboard or by using the test endpoint in your automated CI/CD test pipelines.
Checklist Before Going Live
- Replace all
sk_test_keys with productionsk_live_keys in your production environment variables. - Register your production HTTPS webhook URL in the Live environment tab.
- Verify that your webhook receiver enforces HMAC-SHA256 signature verification.
- Confirm your organization profile details and billing contact information in the Business Portal.
Was this page helpful?