ZamuPay API Documentation
    ZamuPay API Documentation
    • Zamupay overview
    • Token Request
      POST
    • Payment Order Request
      POST
    • Reject Order By OriginatorConversationId
      POST
    • Express Deposit Request
      POST
    • Find Payment Order By OriginatorConversationId
      GET
    • Find Express Deposit By OriginatorConversationId
      GET
    • Bill Number
      POST
    • Find Bill Number By Service Id and Account Number
      GET
    • Find Transaction Routes
      GET
    • Find Charges By TransactionTypeId
      GET
    • Bill Request
      POST
    • Find Bill Request By Originator Converstion Id
      GET
    • Find Bill Services
      GET
    • Account Number Validation Request
      POST
    • Find Account Validation Status by SystemTraceAuditNumber
      GET
    • Airtime Purchase
      POST
    • Find Airtime Purchases By OriginatorConversationId
      GET
    • Health Check
      GET
    • Create Payment Link
      POST
    • Find Payment Links By Id
      GET
    • Update Payment Link
      PUT
    • KYC Validation
      POST
    • KYC Validation
      GET
    • Balance Check
      GET

      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 2025-12-09 12:39:20
      Previous
      Bill Request
      Next
      Find Bill Services
      Built with