DigiCash Setup

Retrieve API Credentials

Once your merchant account is approved, the DigiCash team issues your API credentials:

• Client ID — identifies your merchant account
• Client Secret (API Key) — authenticates your requests

Keep the Client Secret private — anyone holding it can initiate charges on your account.

Activate Your Mobile Networks

Each mobile network is a separate assigned service on your DigiCash merchant account. Customers can only pay through networks that DigiCash has activated for you, so make sure every network your subscribers use is enabled:

• Airtel Money
• M-Pesa (Vodacom) — requires merchant registration with M-Pesa first; the DigiCash team coordinates connecting your M-Pesa wallet
• Tigo Pesa
• HaloPesa

VillageHub automatically detects the customer's network from their phone number and charges through the matching service — no extra configuration needed on your side.

Configure Settings in VillageHub

Go to your Admin Panel → Settings → Payments. Select DigiCash (Tanzania) as the payment gateway and paste your Client ID and Client Secret.

Running multiple sites? You can also point an individual router at DigiCash (or its own credentials) from the router's payment override on the router detail page.

Payment Confirmations Are Automatic

There is no webhook to configure in any DigiCash dashboard — VillageHub sends its callback URL with every payment request, and DigiCash posts the result there the moment your customer approves or declines the prompt. Every confirmation is additionally re-verified against the DigiCash API before internet access is granted. For reference, the callback endpoint is:

Good to know: DigiCash transactions are limited to TZS 500 – 5,000,000. The USSD approval prompt works on both feature phones and smartphones.