Luku Token Purchase API

Stable Payments

This API facilitates the purchase of Luku tokens for prepaid electricity meters with meter number verification and token purchase functionality.

Overview

Use Cases

Meter Number Detail Inquiry
Token Purchase
Callback Notifications

Key Features

Prepaid electricity meter support
Token generation
Real-time processing
Customer verification

Code Examples

Example requests for the Luku Token Purchase API

curl -X POST "https://api.nmbbank.com/v1/payments/luku/verify" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "requestDetails": {
      "sourceId": "eteller",
      "billerCode": "LUKU",
      "billerOperationCode": "INQ"
    },
    "requestBody": {
      "gepgBillQryReq": {
        "billReqId": "eTeller12345",
        "meterNum": "24730238417"
      }
    }
  }'

curl -X POST "https://api.nmbbank.com/v1/payments/luku/purchase" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "requestDetails": {
      "sourceId": "eTeller",
      "billerCode": "LUKU",
      "billerOperationCode": "PAY",
      "callbackURL": "http://luku.com/cb"
    },
    "requestBody": {
      "pymTrxDetails": {
        "requestId": "eTeller99117089127",
        "meterNum": "24730238417",
        "billAmount": "1000",
        "currency": "TZS",
        "debitAccount": "20102503452",
        "dptCellNum": "255763328665",
        "dptName": "KASORE GABRIEL NYABUTA",
        "dptEmailAddr": "e.kweka@gmail.com"
      }
    }
  }'

Response Examples

Verification Response

{
  "statusCode": 600,
  "message": "Success",
  "body": {
    "gepgVendCustInfoRes": {
      "gwxReference": "GWX800930701197",
      "meterNum": "24730238417",
      "owner": "KASORE GABRIEL NYABUTA",
      "payRefId": "GWX800930701197",
      "rcptNum": "202306141018422348674"
    }
  }
}

Purchase Response

{
  "statusCode": 600,
  "message": "Accepted",
  "body": {
    "remark": "Request received for processing"
  }
}

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.