GePG (Government Payments) API

Stable Payments

This API facilitates government payments using control numbers with bill verification, payment submission, and callback notifications.

Overview

Use Cases

Bill Verification
Payment Submission
Callback Notifications

Key Features

Government payment integration
Control number validation
Real-time processing
Multi-channel support

Code Examples

Example requests for the GePG API

curl -X POST "https://api.nmbbank.com/v1/payments/gepg/verify" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "requestDetails": {
      "sourceId": "E-TELLER",
      "billerCode": "GEPG",
      "billerOperationCode": "INQ"
    },
    "requestBody": {
      "gepgBillQryReq": {
        "requestId": "ET2093651186",
        "controlNum": "991043383705"
      }
    }
  }'

curl -X POST "https://api.nmbbank.com/v1/payments/gepg/pay" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "requestDetails": {
      "sourceId": "to be provided",
      "channelCategory": "AIRTELMONEY",
      "billerCode": "C2B",
      "callbackURL": "Client to share"
    },
    "requestBody": {
      "paymentTransactionDetails": {
        "requestId": "A12327843859",
        "walletId": "001001",
        "custCtrNum": "997040008456",
        "payType": "1",
        "entry count": "1",
        "amount": "10000",
        "thirdpartyReference": "AIRTEL12141378",
        "dptCellNum": "255764556789",
        "debitAccount": "test",
        "sourceBranch": null
      }
    }
  }'

Response Examples

Success Response

{
  "statusCode": 600,
  "message": "Success",
  "body": {
    "gepgBillQryResp": {
      "billHdr": {
        "billStsDesc": "Successful",
        "billStsCode": 7101,
        "billReqId": "GWX800930051666",
        "payType": "2",
        "entryCnt": "1",
        "sysCode": "NMBT001",
        "custCtrNum": "991031226952"
      }
    }
  }
}

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.