Get Transaction Status

{{URL}}/api/cps/v1/getTransactionStatus

This endpoint is used to get the status of a transaction.

AUTHORIZATION

UsernamePassword
Username{{USERNAME}}
Password{{SECRETKEY}}

BODY PARAMS

{
  "transactionReference": "sm23oyr1122"
}

Request Parameters

NameTypeDescriptionOptional Mandatory
transactionReferenceStringUnique transaction reference IDtrue

Example Request

var raw = "{
  "transactionReference": "sm23oyr1122"
}";

var requestOptions = {
  method: 'POST',
  body: raw,
  redirect: 'follow'
};

fetch("{{URL}}/api/cps/v1/getTransactionStatus", requestOptions)
  .then(response => response.text())
  .then(result => console.log(result))
  .catch(error => console.log('error', error));

Response Parameters

NameTypeDescriptionOptional Mandatory
amountNumberTransaction Amounttrue
paymentReferenceStringPayment reference idtrue
transactionDateStringTransaction datetrue
feesNumberTransaction charge feetrue
currencyStringTransaction currencytrue
responseCodeNumberStatus code of requesttrue
responseDescriptionNumberStatus description of requesttrue

Example Response

{
  "amount": "2.03",
  "paymentReference": "sm23oyr1122",
  "transactionDate": "06/10/2023 00:28",
  "currency": "NGN",
  "fees": 0.03,
  "channel": "CARD",
  "responseCode": "00",
  "responseDescription": "Transaction Successful"
}

Did you find this page helpful?