---
title: "Check Transaction Status(Merchant Reference)"
method: GET
path: "/merchant-collection/transfer_notification_controller/merchant/transaction-query?merchant_reference={merchantReference}"
tags: ["Check Transaction Status(Merchant Reference)"]
---

# Check Transaction Status(Merchant Reference)

`GET /merchant-collection/transfer_notification_controller/merchant/transaction-query?merchant_reference={merchantReference}`

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

| Status | Meaning |
| :--- | :--- |
| Initialized | The transaction is in progress |
| Completed | The transaction is successful |
| Failed | The transaction has failed |

## Path parameters

- `merchantReference` string, required

## Response `200`

Request Successful

- TsqMerchantReferenceResponse
  - `message` string — Descriptive message regarding the response.
  - `data` object — The detailed transaction information.
    - `transaction_reference` string, nullable — Payaza's unique transaction reference.
    - `amount_received` number, double — The actual amount received.
    - `transaction_fee` number, double — Fee deducted for processing the transaction.
    - `transaction_status` string — Current status of the transaction.
    - `sender_name` string, nullable — Name of the sender or cardholder.
    - `sender_account_number` string, nullable — Sender's account number (if applicable).
    - `source_bank_name` string, nullable — Name of the source bank or card network.
    - `initiated_date` string — Timestamp when the transaction was initiated.
    - `current_status_date` string — Timestamp when the transaction reached its current status.
    - `currency` string — 3-letter currency code.
    - `session_id` string — Unique session identifier for the transaction.
    - `merchant_transaction_reference` string — The merchant's original transaction reference.
    - `transaction_type` string — The channel or method used for the transaction.
    - `virtual_account_number` string, nullable — Virtual account number used, if applicable.
    - `status_reason` string — Detailed reason or message corresponding to the status.
  - `success` boolean — Indicates whether the request was successful.

## Other responses

- `400` — Payment failed

---

[API](https://skmtc.net/payaza/apis/payaza-documentation.md) · [All operations](https://skmtc.net/payaza/apis/payaza-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/payaza/payaza-documentation/revisions/1ecd4b94ff07/schema)