QR Payments API

Stable Payments

This API enables payments through the Tanzania Instant Payment System (TIPS) with QR code functionality for merchant verification and payment processing.

Overview

Use Cases

Merchant Name Verification
Payment Submission
Callback Notifications

Key Features

TIPS integration
QR code support
Real-time processing
Merchant verification

API Endpoints

POST /api/v1/payments/qr/verify

Merchant Name Verification

Verify merchant details before processing QR payment

Parameters

sourceId string Required

Source identifier

identifier string Required

Merchant identifier

transactionReference string Required

Transaction reference

fspDestination string Required

FSP destination code

identifierType string Required

Identifier type (BANK/MSISDN)

POST /api/v1/payments/qr/submit

QR Payment Submission

Process QR payment through Tanzania Instant Payment System (TIPS)

Key Parameters

payer object Required

Payer details object

payee object Required

Payee details object

amount object Required

Amount and currency object

Code Examples

Example requests for the QR Payments API

curl -X POST "https://api.nmbbank.com/v1/payments/qr/verify" \
 -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
 -H "Content-Type: application/json" \
 -d '{
   "requestBody": {
     "sourceId": "NMBMobileTest",
     "identifier": "001000347312",
     "transactionReference": "GWX10937635634",
     "fspDestination": "031",
     "identifierType": "BANK"
   }
 }'

curl -X POST "https://api.nmbbank.com/v1/payments/qr/submit" \
 -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
 -H "Content-Type: application/json" \
 -d '{
   "requestBody": {
     "transactionReference": "0167k04ehseG63",
     "payeeAddress": "Dar es Salaam",
     "sourceId": "Pamoja",
     "sortCode": "CORUTZTZXXX",
     "cbsReference": "101FTIP101015050505",
     "payer": {
       "identifierType": "BANK",
       "identifier": "40410007770",
       "fspId": "016",
       "fullName": "Ally Mtoni",
       "accountCategory": "PERSON",
       "accountType": "BANK",
       "identity": {
         "type": "NIN",
         "value": "19331007175010005135"
       }
     },
     "payee": {
       "identifierType": "MSISDN",
       "identifier": "255621804189",
       "fspId": "004",
       "fullName": "Alex Junior",
       "accountCategory": "PERSON",
       "accountType": "WALLET",
       "identity": {
         "type": "NIN",
         "value": "19431007175010005136"
       }
     },
     "amount": {
       "amount": 100,
       "currency": "TZS"
     },
     "endUserFee": {
       "amount": 5,
       "currency": "TZS"
     },
     "transactionType": {
       "scenario": "TRANSFER",
       "initiator": "CUSTOMER",
       "initiatorType": "SENDER"
     },
     "description": "NMB Payment"
   }
 }'

Response Examples

Verification Response

{
 "statusCode": 600,
 "message": "Success",
 "body": {
   "identifierType": "BANK",
   "identifier": "001000347312",
   "fspId": "031",
   "fullName": "DENNIS RENATUS KOMBA",
   "accountCategory": "PERSON",
   "accountType": "BANK",
   "identity": {
     "type": "NIN",
     "value": ""
   }
 }
}

Payment Response

{
 "statusCode": 600,
 "message": "Success",
 "body": {
   "cbsReference": "101OTFT210240139"
 }
}

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.