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

200

{
  "status": "success",
  "data": {
    "AmountPaid": "100000.00",
    "FriendlyMessage": "Transaction completed successfully",
    "FurtherExplanation": null,
    "IsSuccessful": true,
    "PayerEmail": "[e-mail]",
    "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.