v1

latestOpenAPI 3.0.12026-07-225791279.7 KB
Check Transaction Status(Merchant Reference)

Check Transaction Status(Merchant Reference)

This endpoint is used to check the transaction status of a transaction using the Merchant Reference.

StatusMeaning
InitializedThe transaction is in progress
CompletedThe transaction is successful
FailedThe transaction has failed
get/merchant-collection/transfer_notification_controller/merchant/transaction-query?merchant_reference={merchantReference}

Path parameters

merchantReferencestring required

The reference generated to the transaction that is placed in the Checkout or Payment page request

Response

Request Successful

messagestring

Descriptive message regarding the response.

successboolean

Indicates whether the request was successful.

Example response

{
  "message": "Transaction data found",
  "data": {
    "amount_received": 20.28,
    "transaction_fee": 0.28,
    "transaction_status": "Completed",
    "sender_name": "Ray Phil",
    "source_bank_name": "MASTERCARD",
    "initiated_date": "2023-02-11 09:49:09.254",
    "current_status_date": "2023-02-11 09:49:09.254",
    "currency": "NGN",
    "session_id": "419309171231",
    "merchant_transaction_reference": "3bf267326",
    "transaction_type": "Card",
    "status_reason": "Payment Approved"
  },
  "success": true
}