Back to API Catalogue

Transfer to Mobile API

Stable Money Transfer

This API facilitates transfers to mobile money accounts including M-Pesa, Airtel Money, Halotel, TTCL, and Tigo Pesa.

Overview

Supported Providers

M-Pesa (Vodacom)
Airtel Money
Halotel
TTCL
Tigo Pesa

Key Features

Multi-provider support
Real-time processing
Secure transfers
Callback notifications

API Endpoints

POST /api/v1/transfer/mobile

Transfer to Mobile

Send money directly to mobile wallets and mobile money platforms

Parameters

sourceAccount string Required

Source account number

recipientMobile string Required

Recipient mobile number

amount number Required

Transfer amount

currency string Required

Currency code (e.g., TZS)

provider string Required

Mobile money provider (M-Pesa, Airtel, etc.)

reference string

Transaction reference

callbackURL string

Callback URL for notifications

Code Examples

Example requests for the Transfer to Mobile API

curl -X POST "https://api.nmbbank.com/v1/transfer/mobile" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "sourceAccount": "24110000296",
    "recipientMobile": "255754123456",
    "amount": 50000,
    "currency": "TZS",
    "provider": "M-Pesa",
    "reference": "Mobile transfer to family",
    "callbackURL": "https://yourapp.com/callback"
  }'

const response = await fetch('https://api.nmbbank.com/v1/transfer/mobile', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_ACCESS_TOKEN',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    sourceAccount: '24110000296',
    recipientMobile: '255754123456',
    amount: 50000,
    currency: 'TZS',
    provider: 'M-Pesa',
    reference: 'Mobile transfer to family',
    callbackURL: 'https://yourapp.com/callback'
  })
});

const data = await response.json();
console.log(data);

import requests

url = "https://api.nmbbank.com/v1/transfer/mobile"
headers = {
    "Authorization": "Bearer YOUR_ACCESS_TOKEN",
    "Content-Type": "application/json"
}

data = {
    "sourceAccount": "24110000296",
    "recipientMobile": "255754123456",
    "amount": 50000,
    "currency": "TZS",
    "provider": "M-Pesa",
    "reference": "Mobile transfer to family",
    "callbackURL": "https://yourapp.com/callback"
}

response = requests.post(url, json=data, headers=headers)
print(response.json())

Response Examples

Success Response

{
  "status": "success",
  "transactionId": "TXN123456789",
  "reference": "Mobile transfer to family",
  "amount": 50000,
  "currency": "TZS",
  "provider": "M-Pesa",
  "recipientMobile": "255754123456",
  "timestamp": "2024-01-15T10:30:00Z"
}

Quick Info

Base URL: https://www.fintech.nmbbank.co.tz

Authentication: Bearer Token

Content Type: application/json

Support

Need help with this API? Contact our support team.