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 13 | Fails; a payout reverts and the balance comes back |
Destination ending 02 | reconcile_required: burned, unconfirmed, no refund |
Amount or destination ending 99 | Stays pending forever. Test your timeouts |
Destination ending 00 | No registered name (the unverified-destination warning) |
Lipa till 61115582 / 70031820 | ENZI COFFEE COMPANY LIMITED / NEDA LABS LIMITED |
NIDA ending 0000 | 202 kyc_pending_review; clear it with the approve endpoint |
Anything else | Completes |
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