Tanzania

Supported payment methods and integration details for Tanzania

Country Details

Country ID: 10 • Country Code: 255 • Currency: TZS (Tanzanian Shilling)

Supported Payment Methods & Payload Requirements

Channel	Flow	`payment_method_type`	Required Payload Array / Fields	Destination / Operator	API Reference
Airtel Money	Deposit	`"airtel"`	`mobile` (format: `"255XXXXXXXXX"`)	Airtel Tanzania (USSD prompt)	Collections API
Halotel	Deposit	`"halotel"`	`mobile` (format: `"255XXXXXXXXX"`)	Halotel HaloPesa (STK prompt)	Collections API
Tigo (Mixx by YAS)	Deposit	`"tigo"`	`mobile` (format: `"255XXXXXXXXX"`)	Tigo Tanzania (STK prompt)	Collections API
Vodacom M-Pesa	Deposit	`"vodacom"`	`mobile` (format: `"255XXXXXXXXX"`)	Vodacom Tanzania (STK PIN prompt)	Collections API
Airtel Money	Payout	`"Airtel"`	`Airtel: [{"phone_number": "255XXXXXXXXX"}]`	Airtel Tanzania Mobile Wallet	Payments API
Halotel	Payout	`"Halotel"`	`Halotel: [{"phone_number": "255XXXXXXXXX"}]`	Halotel HaloPesa Mobile Wallet	Payments API
Tigo (Mixx by YAS)	Payout	`"Tigo"`	`Tigo: [{"phone_number": "255XXXXXXXXX"}]`	Tigo Tanzania Mobile Wallet	Payments API
Vodacom M-Pesa	Payout	`"Vodacom"`	`Vodacom: [{"phone_number": "255XXXXXXXXX"}]`	Vodacom Tanzania Mobile Wallet	Payments API

Payment Flow: How It Works

Deposits (Collections)

Initiation: Submit a signed POST request to the Unified Collections endpoint with country_id: 10, currency: "TZS", amount, payment_method_type ("airtel", "halotel", "tigo", or "vodacom"), and the customer’s phone number in mobile (format: 255XXXXXXXXX).
Handset Authorization: The customer receives a prompt on their handset to enter their PIN and authorize the debit.
Initial Response: Niobi returns an acknowledgement (payment_step: 1) containing the assigned depositId.
Callback Confirmation: Once authorized, Niobi delivers an asynchronous webhook callback (payment_step: 2, status: "success") to your callback_url.

Payouts (Disbursements)

When initiating a payout to Tanzania via the Unified Payments endpoint, pass the appropriate payment_method_type and its corresponding nested array:

Airtel Money: Pass payment_method_type: "Airtel" with an Airtel array containing phone_number.
Halotel: Pass payment_method_type: "Halotel" with a Halotel array containing phone_number.
Tigo (Mixx by YAS): Pass payment_method_type: "Tigo" with a Tigo array containing phone_number.
Vodacom M-Pesa: Pass payment_method_type: "Vodacom" with a Vodacom array containing phone_number.

Sample Requests & Responses

Vodacom M-Pesa Deposit Request

{
    "client_id": "YOUR_CLIENT_ID",
    "params": {
        "amount": 10000,
        "callback_url": "https://example.com/callback",
        "country_id": 10,
        "currency": "TZS",
        "email": "customer@example.com",
        "first_name": "John",
        "last_name": "Doe",
        "mobile": "255750000000",
        "payment_method_type": "vodacom",
        "third_party_reference_1": "TX-TZA-DEP-1001",
        "third_party_reference_2": "CUST-1001"
    },
    "salt": "random_salt_12345",
    "sender": "YOUR_INTEGRATION_NAME",
    "timestamp": 1724835600,
    "signature": "a1b2c3d4e5f60718293a4b5c6d7e8f90123456789abcdef0123456789abcdef0"
}

Deposit Response (Initiation)

{
    "success": true,
    "message": "Payment process initiated successfully.",
    "data": {
        "account_name": "John Doe",
        "amount": 10000,
        "callback_url": "https://example.com/callback",
        "country_id": 10,
        "currency": "TZS",
        "depositId": "dep_12345678",
        "mobile": "255750000000",
        "payment_method_type": "vodacom",
        "payment_step": 1,
        "status": "success",
        "third_party_reference_1": "TX-TZA-DEP-1001"
    },
    "status_code": "000000"
}

Payout Request (Vodacom M-Pesa)

{
    "client_id": "YOUR_CLIENT_ID",
    "params": {
        "amount": 5000,
        "client_callback_url": "https://example.com/callback",
        "country_id": 10,
        "currency": "TZS",
        "first_name": "John",
        "last_name": "Doe",
        "mobile": "255720993649",
        "payment_method_type": "Vodacom",
        "payment_reference": "YOUR-PAYOUT-REF",
        "third_party_reference_1": "TX-TZA-DISB-2001",
        "Vodacom": [
            {
                "phone_number": "255720993649"
            }
        ]
    },
    "salt": "random_salt_12345",
    "sender": "YOUR_INTEGRATION_NAME",
    "timestamp": 1724835600,
    "signature": "a1b2c3d4e5f60718293a4b5c6d7e8f90123456789abcdef0123456789abcdef0"
}

Payout Response (Initiation)

{
    "success": true,
    "message": "Payment process initiated successfully.",
    "data": {
        "creation_date": "2026-08-28T12:30:00.000000Z",
        "from": "YOUR_INTEGRATION_NAME",
        "payment_step": 1,
        "reference": "ref_98765432",
        "to": "255720993649",
        "total": 5000,
        "type": "Vodacom M-Pesa"
    },
    "status_code": "000000"
}

Webhook/Callback Examples

Successful Deposit Callback

{
    "client_id": "YOUR_CLIENT_ID",
    "salt": "random_salt_12345",
    "sender": "YOUR_INTEGRATION_NAME",
    "timestamp": 1724835600,
    "signature": "a1b2c3d4e5f60718293a4b5c6d7e8f90123456789abcdef0123456789abcdef0",
    "params": {
        "amount": 10000,
        "currency": "TZS",
        "depositId": "dep_12345678",
        "email": "customer@example.com",
        "mobile": "255750000000",
        "name": "John Doe",
        "payment_step": 2,
        "status": "success",
        "status_code": "000000",
        "third_party_reference_1": "TX-TZA-DEP-1001",
        "third_party_reference_2": "CUST-1001"
    }
}

Successful Payout Callback

{
    "client_id": "YOUR_CLIENT_ID",
    "salt": "random_salt_12345",
    "sender": "YOUR_INTEGRATION_NAME",
    "timestamp": 1724835600,
    "signature": "a1b2c3d4e5f60718293a4b5c6d7e8f90123456789abcdef0123456789abcdef0",
    "params": {
        "account": "255720993649",
        "amount": 5000,
        "currency": "TZS",
        "fee": 50,
        "message": "Payment was transferred successfully.",
        "mobile": "255720993649",
        "payee": "John Doe",
        "payment_channel": "Vodacom M-Pesa",
        "payment_reference": "YOUR-PAYOUT-REF",
        "payment_step": 2,
        "payoutId": "bd8f51a2-xxxx-xxxx-xxxx-xxxxx9a",
        "ref": "ref_98765432",
        "status": "success",
        "statusCode": "000000",
        "third_party_reference_1": "TX-TZA-DISB-2001",
        "third_party_reference_2": null,
        "transaction_date": "2026-08-28 12:30:00",
        "transaction_detail": "Disbursement made through Vodacom M-Pesa",
        "type": "Pay out"
    }
}

Try it

Try it: POST /api/v4/niobi-unified-collections

Collections API reference for Tanzania deposits.

Try it: POST /api/v4/niobi-unified-payments

Payments API reference for Tanzania payouts.

Transaction Limits

For the full list of minimum and maximum transaction limits for Tanzania (TZS) collections and payouts, please see the Transaction Limits for Tanzania section on the Transaction Limits page.

Get Started with Niobi

API Authentication

Collecting Payments

Making Payments

Transaction Status

Supporting Documentation

Tanzania | Supported Payment Methods & Corridors

Tanzania

Supported Payment Methods & Payload Requirements

Payment Flow: How It Works

Deposits (Collections)

Payouts (Disbursements)

Sample Requests & Responses

Vodacom M-Pesa Deposit Request

Deposit Response (Initiation)

Payout Request (Vodacom M-Pesa)

Payout Response (Initiation)

Webhook/Callback Examples

Successful Deposit Callback

Successful Payout Callback

Try it

Try it: POST /api/v4/niobi-unified-collections

Try it: POST /api/v4/niobi-unified-payments

Transaction Limits

​Tanzania

​Supported Payment Methods & Payload Requirements

​Payment Flow: How It Works

​Deposits (Collections)

​Payouts (Disbursements)

​Sample Requests & Responses

​Vodacom M-Pesa Deposit Request

​Deposit Response (Initiation)

​Payout Request (Vodacom M-Pesa)

​Payout Response (Initiation)

​Webhook/Callback Examples

​Successful Deposit Callback

​Successful Payout Callback

​Try it

Try it: POST /api/v4/niobi-unified-collections

Try it: POST /api/v4/niobi-unified-payments

​Transaction Limits

Tanzania

Supported Payment Methods & Payload Requirements

Payment Flow: How It Works

Deposits (Collections)

Payouts (Disbursements)

Sample Requests & Responses

Vodacom M-Pesa Deposit Request

Deposit Response (Initiation)

Payout Request (Vodacom M-Pesa)

Payout Response (Initiation)

Webhook/Callback Examples

Successful Deposit Callback

Successful Payout Callback

Try it

Transaction Limits