v2: Query Status with Collecta Reference

The second way you can query for the status of a transaction, this time, using the Collecta reference that is returned to your ReturnURL through URL query parameters

Query Transaction Status

GET https://app.collecta.com.ng/query/status

Get transaction status using Collecta Reference

Query Parameters

Name
Type
Description

transactionRef

string

The Collecta Reference returned as Ref URL parameter to your ReturnURL

Headers

Name
Type
Description

Hash

string

SHA256 of Amount in two decimal places + MerchantId + SecretKey

{
  "status": "success",
  "data": {
    "AmountPaid": "100000.00",
    "FriendlyMessage": "Transaction completed successfully",
    "FurtherExplanation": null,
    "IsSuccessful": true,
    "PayerEmail": "email@collecta.com.ng",
    "PayerName": "SOLOMON GRUNDY",
    "PaymentReference_Local": "COLLECTAREFERENCE",
    "PaymentReference_Switch": "SWITCHREFERENCE",
    "ResponseCode": "00",
    "ResponseDescription": "Approved By Financial Institution",
    "TransactionDate": "02/06/2018",
    "TransactionType": "School Fees"
  }
}

JSON of status and data. data will carry transaction response object if status = success. It will carry a string representation of the error message if status = error.

Always look out for the IsSuccessful property of the data object in the response. A status=success alone is not enough to determine that your transaction is successful

Its always a good practice to log all responses from Collecta for future reference.

Previousv2: Query Status with your ReferenceNextv2: Sample Code

Last updated