Transfer to NMB Accounts API

Stable Money Transfer

This API enables transfers to NMB Bank accounts with support for beneficiary account lookup, transfer processing, and callback notifications.

Overview

Use Cases

Beneficiary Account Lookup
Transfer Processing
Callback Notifications

Key Features

Instant transfers between NMB accounts
Real-time transaction processing
Secure authentication and authorization
Callback URL support for notifications

API Endpoints

POST /api/v1/transfer/nmb-accounts

Transfer to NMB Accounts

Transfer funds between NMB Bank accounts instantly and securely

Parameters

clientID string Required

Client identifier

requestID string Required

Unique request identifier

recipientType string Required

Type of recipient (e.g., BANK)

recipientBIC string Required

Bank Identifier Code

recipientInstitutionName string Required

Name of recipient institution

recipientAccountNumber string Required

Recipient account number

recivierName string Required

Recipient name

paymentReason string Required

Reason for payment

amount string Required

Transfer amount

currency string Required

Currency code (e.g., TZS)

dateTime string Required

Transaction date and time

senderNationality string Required

Sender nationality

senderFullname string Required

Sender full name

senderPhysicalAddress string Required

Sender physical address

senderDob string Required

Sender date of birth

CALLBACK_URL string Required

Callback URL for notifications

Code Examples

Example requests for the Transfer to NMB Accounts API

curl -X POST "https://api.nmbbank.com/v1/transfer/nmb-accounts" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "request": {
      "clientID": "thunes",
      "requestID": "THU3000700300",
      "recipientType": "BANK",
      "recipientBIC": "003",
      "recipientInstitutionName": "NMB Bank Plc",
      "recipientAccountNumber": "24110000296",
      "recivierName": "Mwinyi Kazimoto",
      "paymentReason": "Family",
      "amount": "25000",
      "currency": "TZS",
      "dateTime": "2022-04-05 18:43:04",
      "senderNationality": "TZ",
      "senderFullname": "Mtemi Mtemi",
      "senderPhysicalAddress": "VIVA TOWERS",
      "senderDob": "2022-04-05",
      "CALLBACK_URL": "https://nala-terrapay-thunes/mtoinbound"
    }
  }'

const response = await fetch('https://api.nmbbank.com/v1/transfer/nmb-accounts', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_ACCESS_TOKEN',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    request: {
      clientID: 'thunes',
      requestID: 'THU3000700300',
      recipientType: 'BANK',
      recipientBIC: '003',
      recipientInstitutionName: 'NMB Bank Plc',
      recipientAccountNumber: '24110000296',
      recivierName: 'Mwinyi Kazimoto',
      paymentReason: 'Family',
      amount: '25000',
      currency: 'TZS',
      dateTime: '2022-04-05 18:43:04',
      senderNationality: 'TZ',
      senderFullname: 'Mtemi Mtemi',
      senderPhysicalAddress: 'VIVA TOWERS',
      senderDob: '2022-04-05',
      CALLBACK_URL: 'https://nala-terrapay-thunes/mtoinbound'
    }
  })
});

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

import requests
import json

headers = {
    'Authorization': 'Bearer YOUR_ACCESS_TOKEN',
    'Content-Type': 'application/json'
}

data = {
    "request": {
        "clientID": "thunes",
        "requestID": "THU3000700300",
        "recipientType": "BANK",
        "recipientBIC": "003",
        "recipientInstitutionName": "NMB Bank Plc",
        "recipientAccountNumber": "24110000296",
        "recivierName": "Mwinyi Kazimoto",
        "paymentReason": "Family",
        "amount": "25000",
        "currency": "TZS",
        "dateTime": "2022-04-05 18:43:04",
        "senderNationality": "TZ",
        "senderFullname": "Mtemi Mtemi",
        "senderPhysicalAddress": "VIVA TOWERS",
        "senderDob": "2022-04-05",
        "CALLBACK_URL": "https://nala-terrapay-thunes/mtoinbound"
    }
}

response = requests.post(
    'https://api.nmbbank.com/v1/transfer/nmb-accounts',
    headers=headers,
    json=data
)

result = response.json()
print(result)

Response Examples

Success Response

{
  "request": {
    "requestID": "123456",
    "responsecode": "00",
    "responsedescription": "SUCCESS",
    "extraInfo": "EXTRA INFO",
    "bankRef": "123456"
  }
}

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.