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 Account Validation Status by SystemTraceAuditNumber

      https://auth.zamupay.com
      https://auth.zamupay.com
      https://auth.zamupay.com
      https://auth.zamupay.com
      GET
      /v1/account/query
      This is a GET request that is used to check the status of an Account Validation Request using a generated SystemTraceAuditNumber by the consumer.

      Sample Response#

      {
        "validationType": 1,
        "validationTypeDesc": "Mobile",
        "accountNumber": "+254714653433",
        "accountNumberCCY": "KES",// currency in which the account number transacts
        "institutionCode": "63902", // institution number, either mobile mccmnc or bank code
        "countryCode": "KE",
        "callbackURL": "https://eo2j2658kmohqiy.m.pipedream.net",
        "status": 4,
        "statusDesc": "Completed",
        "systemTraceAuditNumber": "f9445f06-2a9a-456e-98a0-5f9db5d3a202",
        "conversationID": "AG_20230720_2010431240a6879fd40b",//unique Id from Mobile Provider
        "responseCode": "0",
        "responseDesc": "Accept the service request successfully.",
        "resultCode": "0",
        "resultDesc": "The service request is processed successfully.",
        "transactionID": "RGK71AERRN",
        "transactionCreditParty": "254702900800 - JOHN DOE",//Contains the details for the validated primary account number
        "createdDate": "2023-08-03T06:01:21.15"
      }
      

      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/account/query?stan' \
      --header 'Authorization: Bearer <token>'
      Response Response Example
      {}
      Modified at 2025-12-09 12:39:20
      Previous
      Account Number Validation Request
      Next
      Airtime Purchase
      Built with