Skip to content

Get started

Test mode

Build the whole integration before a single shilling moves. Test keys hit the same endpoints and return the same shapes, with simulated money, simulated identity and simulated payment providers.

What is real: the fee maths, the quote signatures and expiry, every validation rule and error code, and the webhooks (really delivered, really signed, carrying livemode: false). What is simulated: the blockchain, the payment providers and the identity registry. Test data lives in its own tables and can never touch the nTZS reserve or supply.
Use this value……and you get
Amount (deposit) or destination (payout) ending 13Fails; a payout reverts and the balance comes back
Destination ending 02reconcile_required: burned, unconfirmed, no refund
Amount or destination ending 99Stays pending forever. Test your timeouts
Destination ending 00No registered name (the unverified-destination warning)
Lipa till 61115582 / 70031820ENZI COFFEE COMPANY LIMITED / NEDA LABS LIMITED
NIDA ending 0000202 kyc_pending_review; clear it with the approve endpoint
Anything elseCompletes
One deliberate difference: test mode runs every rail, including ones not yet switched on in production.GET /api/v1/testmodereports which rails are actually live, so build ahead, but check there before you promise a launch date.
Get sandbox credentials: no contract, no waiting
curl -X POST https://www.ntzs.co.tz/api/v1/testmode/signup \
  -H "Content-Type: application/json" \
  -d '{"name":"Acme Bank","email":"dev@acme.co.tz"}'

# → { "apiKey": "ntzs_test_…", "webhookSecret": "whsec_…" }
# Then point every call below at that key. Start with:
curl https://www.ntzs.co.tz/api/v1/testmode \
  -H "Authorization: Bearer ntzs_test_xxxxxxxxxxxx"
Drive the simulation
# Settle every pending transaction now (instead of waiting ~3s)
POST /api/v1/testmode/advance

# Clear a simulated manual KYC review
POST /api/v1/testmode/users/{userId}/approve

# Wipe every test user and transaction on this key
POST /api/v1/testmode/reset