Payout TSC

A merchant can use this endpoint to check transaction statuses, verify payments, resolve disputes, sync records, and automate fulfillment workflows.

GET https://transfer.dev.mypaygate.co/api/v1/transactions/{transactionReference}/query

The Payout Transaction lookup endpoint retrieves the details and status of a specific transaction by its unique identifier. This endpoint is used to verify transaction completion, check payment statuses, or audit historical records.

Path Variables

Name	Type	Description
transactionReference	String	Your Transaction Reference (Required)

Headers

Name	Type	Description
x-api-key*	String	Base_64(merchant public key)

Sample Request

curl --location 'https://transfer.dev.mypaygate.co/api/v1/transactions/PYG-TST-SUCC-17050521-1751545113/query' --header 'x-api-key: {{BASE64(MERCHANT_PUBLIC_KEY)
}}'

Sample Response

200 OK

{
  "isSuccessful": true,
  "responseCode": "00",
  "responseMessage": "Successful",
  "responseData": {
      "transactionStatus": "COMPLETED",
      "merchantReference": "PYG-TST-SUCC-17050521-1751545113",
      "transactionReference": "PYG-1751545114431266",
      "amount": 100,
      "feeAmount": 0,
      "valueAmount": 100,
      "statusReason": "Successful"
  }
}

400 Bad Request

{
  "isSuccessful": false,
  "responseCode": "25",
  "responseMessage": "Transaction not found"
}