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-Key header.
  • Sandbox idempotency keys are validated but are not persisted for replay.
  • Verification responses include the endpoint price, charged: false, and note: "No charges".
  • GET /v1/balance returns a fixed test balance of 100000 NGN.
  • Sandbox identity records use the fictional identity CHIDINMA ADAEZE NWACHUKWU.

Deterministic test values

InputApplies toResultHTTP
12345678901NINSUCCESSFUL200
22222222222BVNSUCCESSFUL200
08012345678NIN/BVN by phoneSUCCESSFUL200
33333333333NINSUSPENDED200
33333333333BVNBLOCKED200
08033333333NIN by phoneSUSPENDED200
08033333333BVN by phoneBLOCKED200
44444444444 or 08044444444Verification endpointsINSUFFICIENT_BALANCE402
55555555555 or 08055555555Verification endpointsSERVICE_UNAVAILABLE503
Any other valid valueMatching endpointNOT_FOUND200

Test the completed outcomes

Use the deterministic values to exercise every application branch before switching to a live key:

  1. Verified identity.
  2. No record found.
  3. Suspended NIN.
  4. Blocked or watchlisted BVN.
  5. Insufficient balance.
  6. Temporary service failure.
📘

Phone normalization

Phone endpoints accept common Nigerian formats such as 08012345678 and +2348012345678. Idyntic normalizes the value before processing it.


Did this page help you?