Environments and Sandbox
Use deterministic sandbox values to test every response scenario.
The Test Sandbox provides deterministic responses without performing a live identity lookup or charging your wallet.
Sandbox behavior
- Use an API key beginning with
id_test_. - Verification requests still require a valid
Idempotency-Keyheader. - Sandbox idempotency keys are validated but are not persisted for replay.
- Verification responses include the endpoint price,
charged: false, andnote: "No charges". GET /v1/balancereturns a fixed test balance of100000NGN.- Sandbox identity records use the fictional identity CHIDINMA ADAEZE NWACHUKWU.
Deterministic test values
| Input | Applies to | Result | HTTP |
|---|---|---|---|
12345678901 | NIN | SUCCESSFUL | 200 |
22222222222 | BVN | SUCCESSFUL | 200 |
08012345678 | NIN/BVN by phone | SUCCESSFUL | 200 |
33333333333 | NIN | SUSPENDED | 200 |
33333333333 | BVN | BLOCKED | 200 |
08033333333 | NIN by phone | SUSPENDED | 200 |
08033333333 | BVN by phone | BLOCKED | 200 |
44444444444 or 08044444444 | Verification endpoints | INSUFFICIENT_BALANCE | 402 |
55555555555 or 08055555555 | Verification endpoints | SERVICE_UNAVAILABLE | 503 |
| Any other valid value | Matching endpoint | NOT_FOUND | 200 |
Test the completed outcomes
Use the deterministic values to exercise every application branch before switching to a live key:
- Verified identity.
- No record found.
- Suspended NIN.
- Blocked or watchlisted BVN.
- Insufficient balance.
- Temporary service failure.
Phone normalizationPhone endpoints accept common Nigerian formats such as
08012345678and+2348012345678. Idyntic normalizes the value before processing it.
Updated about 2 hours ago
Did this page help you?