1. Bill Payments
ZamuPay API Documentation
  • Introduction
  • Definitions
    • Data Types
  • Authorization
    • Overview
    • Token Request
      POST
    • Find Transaction Routes
      GET
    • Health Check
      GET
  • Checkout Request
    • Overview
    • Checkout Order Request
      POST
    • Query Checkout Request
      GET
    • Checkout Callback Request
      POST
  • Payment Request
    • Payment Order Request
      POST
    • Reject Order By OriginatorConversationId
      POST
    • Find Payment Order By OriginatorConversationId
      GET
  • Collection Request
    • Find Express Deposit By OriginatorConversationId
      GET
    • Express Deposit Request
      POST
  • Bill Payments
    • Bill Number
      POST
    • Find Bill Number By Service Id and Account Number
      GET
    • Bill Request
      POST
    • Find Bill Request By Originator Converstion Id
      GET
    • Find Bill Services
      GET
  • KYC
    • Account Number Validation Request
      POST
    • KYC Validation
      POST
    • KYC Validation
      GET
    • Find Account Validation Status by SystemTraceAuditNumber
      GET
  • Payment Links
    • Find Payment Links By Id
    • Create Payment Link
    • Update Payment Link
  • Customer Accounts
    • Balance Check
    • Find Charges By TransactionTypeId
  • Airtime Purchase
    • Airtime Purchase
    • Find Airtime Purchases By OriginatorConversationId
  1. Bill Payments

Find Bill Request By Originator Converstion Id

https://auth.zamupay.com
https://auth.zamupay.com
https://auth.zamupay.com
https://auth.zamupay.com
GET
/v1/bill-payments
This is a GET request that returns the status of a bill payment transaction.

Sample success response:#

{
    "systemConversationId": "7f520000-0e89-0ee0-3ea2-08d992562380",
    "originatorConversationId": "C22B6TCBHQABIN4UI2JA",
    "serviceID": 2,
    "accountNumber": "254713771963",
    "msisdn": "254713771963",
    "amount": 1.00,
    "datePaymentReceived": "2021-10-18 07:41:31",
    "customerName": "Otis Payer's Name",
    "customerNames": "Otis Payer's Name",
    "countryCode": "KE",
    "currencyCode": "KES",
    "transactionType": 2,
    "dueAmount": 0.0,
    "dueDate": null,
    "narration": "Bill Payment",
    "receiptNumber": null,
    "receiverNarration": null,
    "status": 0,
    "transactionStatusDescription": null,
    "statusCode": -1,
    "statusDescription": "Pending",
    "totalRecordsPendingAck": "0",
    "totalRecordsPendingQuery": "0",
    "active": null,
    "callbackURL": "https://eniufy8w35ok.x.pipedream.net"
}

Request

Authorization
Bearer Token
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
or
Query Params

Responses

🟢200Success
application/json
Body

Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://auth.zamupay.com/v1/bill-payments?OriginatorConversationId' \
--header 'Authorization: Bearer <token>'
Response Response Example
{}
Modified at 2026-01-29 06:17:17
Previous
Bill Request
Next
Find Bill Services
Built with