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

      Reject Order By OriginatorConversationId

      https://auth.zamupay.com
      https://auth.zamupay.com
      https://auth.zamupay.com
      https://auth.zamupay.com
      POST
      /v1/payment-order/reject-order
      This request is used to reject an order already posted using a specified originatorConversationId
      NOTE: This can only be done for transactions in Pending or Queued state (refer to the Transaction Status Types table). For bulk transactions, we can only reject the ones that fit the given criteria.

      Sample response#

      originatorConversationId This a unique identifier of the request from the client
      transactionStatus: This is the value representing the state of the transaction (refer to the Transaction Status Types table)
      transactionDescription: This describes the transactionStatus value.
      resultCode: It is the code representing the result of the reject process.
      resultCodeDescription: It describes the resultCode value
      {
          "paymentOrderlines": [
              {
                  "originatorConversationId": "W765131ei224242t40093334xxiuigggtey",
                  "transactionStatus": 7,
                  "transactionStatusDescription": "Rejected",
                  "resultCode": "1",
                  "resultCodeDescription": "Transaction cannot be rejected on current status"
              }
          ]
      }
      

      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 POST 'https://auth.zamupay.com/v1/payment-order/reject-order?OriginatorConversationId' \
      --header 'Authorization: Bearer <token>'
      Response Response Example
      {}
      Modified at 2025-12-09 12:39:20
      Previous
      Payment Order Request
      Next
      Express Deposit Request
      Built with