Chungwa MTO API Documentation

Introduction

The Chungwa MTO API enables integration partners to perform account lookups and fund transfers through a secure and standardized interface. This documentation covers all available endpoints, request and response formats, authentication requirements, and supported FSPs.

All requests must include valid authentication headers. Requests without credentials will be rejected.

Base URL

All API requests should be made to the following base URL:

Test

https://www.connect.chungwa.co.tz

All endpoints are relative to this base URL. Ensure all requests are made over HTTPS.

Authentication

Authentication is handled via custom HTTP headers. Every request must include a username and password header.

Test Credentials

username chungwa90

password **********

Request Headers

Content-Type: application/json
username: chungwa
password: @Dmin2021!

Account Lookup

POST https://www.connect.chungwa.co.tz/api/chungwa/v1.0/customer-lookup

Lookup an account by identifier (bank account number or mobile number) to retrieve account holder details before initiating a transfer.

Request Parameters

Parameter	Type	Required	Description
clientID	string	Required	Unique client identifier assigned to your integration
requestID	string	Required	Unique request identifier for tracking
identifier	string	Required	Account or mobile number to lookup
identifierType	string	Required	Type of identifier: `BANK` or `MSISDN` or `NIN`
destinationFsp	string	Optional	Accepts numeric code (e.g. `507`) or FSP name (e.g. `AZAMPESA`). Case-insensitive. See Supported FSPs table.

Request Example

JSON Request

POST https://www.connect.chungwa.co.tz/api/chungwa/v1.0/customer-lookup

Headers:
  Content-Type: application/json
  username: chungwa
  password: @Dmin2021!

Body:
{
    "clientID": "client001",
    "requestID": "123456",
    "identifier": "00000121",
    "identifierType": "BANK",
    "destinationFsp": "003"
}

Response Parameters

2

Parameter	Type	Description
responsecode	string	Transaction status code
responsedescription	string	Human readable status description
identifierType	string	Type of the identifier returned
identifier	string	The account or mobile number
fspId	string	FSP owning the identifier
fullName	string	Full name of the account holder
accountCategory	string	`PERSON` or `BUSINESS`
accountType	string	`BANK` or `WALLET`
identity.type	string	ID type: `NIN` or `TIN`
identity.value	string	ID number without hyphens

Response Examples

Success Response (200)

{
    "responsecode": "00",
    "responsedescription": "SUCCESS",
    "identifierType": "BANK",
    "identifier": "00000121",
    "fspId": "CRDB",
    "fullName": "Andendekisye Shekimweri",
    "accountCategory": "PERSON",
    "accountType": "BANK",
    "identity": {
        "type": "TIN",
        "value": "503123579"
    }
}

Not Found Response (404)

{
    "responsecode": "54",
    "responsedescription": "Account not found"
}

Response Codes

00

Successful

Transaction completed successfully

01

Pending

Transaction is being processed

54

Failed

Transaction failed or account not found

55

Cancelled

Transaction was cancelled

96

System Error

Upstream provider error, please retry

Supported FSPs

The following Financial Service Providers are supported for account lookup and fund transfers. Use either the numeric code or FSP name in the destinationFsp field (case-insensitive).

Banks

Numeric Code	FSP Name(s)	Institution
003	CRDB	CRDB Bank
004	NMB	NMB Bank
013	EXIM	Exim Bank
015	NBC	NBC Bank
006	STANBIC	Stanbic Bank
011	DTB	Diamond Trust Bank
009	BOA	Bank of Africa
020	ABSA	ABSA Bank
021	IMB	I&M Bank
040	ECOBANK	Ecobank Tanzania
046	AMANA	Amana Bank
031	AZANIA	Azania Bank
024	DCB	DCB Commercial Bank
034	BANCABC	BancABC
039	MKOMBOZI	Mkombozi Bank
048	TPB	TPB Bank

Mobile Money Operators

Numeric Code	FSP Name(s)	Operator
503	VODACOM / MPESA	Vodacom M-Pesa
504	AIRTEL	Airtel Money
501	TIGO / YAS	Tigo Pesa / Zantel
506	HALOPESA / HALOTEL	Halotel HaloPesa
507	AZAMPESA / AZAM	Azam Mobile Money

Chungwa MTO API v1.0