Transaction Status

1) Get Transaction Status (Using traceID)

Retrieve the current status of a transaction by its unique traceID.

GET /api/transactions/status/{traceID}

Parameter	Type	In	Description
`traceID`	string	path	Unique identifier for the transaction

View full API reference →

Response Examples

{
    "payload": [
        {
            "transactionReference": "428977ac-3043-4fdb-80b5-2b60bee15d68",
            "transactionStatus": 5,
            "transactionStatusDescription": "Processed by acquirer",
            "transactionLastUpdated": "2026-03-18T10:47:44.364Z",
            "traceId": "8e1ca406-a347-436c-b959-ba9334d39c55"
        }
    ]
}

{
    "payload": [
        {
            "transactionReference": "428977ac-3043-4fdb-80b5-2b60bee15d68",
            "transactionStatus": 6,
            "transactionStatusDescription": "Rejected",
            "transactionLastUpdated": "2026-03-18T10:47:44.364Z",
            "traceId": "8e1ca406-a347-436c-b959-ba9334d39c55"
        }
    ]
}

{
    "errors": [
        {
            "type": "FATAL",
            "errorCode": "ELEMENT_NOT_FOUND",
            "message": "No transaction found for trace id: 8e1ca406-a347-436c-b959-ba9334d39c5.",
            "field": "8e1ca406-a347-436c-b959-ba9334d39c5"
        }
    ]
}

❗️
Please note: Only consider response codes 200 (Transaction found) and 404 (Transaction not found) as valid responses. Any 5xx responses are invalid and should be retried. Do not assume that a transaction is not found due to a 5xx response. Note that the transactionReference field may be empty in cases where the reference is yet to be created on our end.

2) Get Transaction Status (Using transactionReference)

Retrieve the current status of a transaction by its unique reference ID.

GET /api/transactions/{transactionReference}/status

Parameter	Type	In	Description
`transactionReference`	string	path	Unique identifier for the transaction

View full API reference →

Response Examples

{
  "payload": [
    {
      "transactionReference": "64ec6629-5a4e-436f-9eca-62c270406d4b",
      "transactionStatus": 5,
      "transactionStatusDescription": "Processed by acquirer",
      "transactionLastUpdated": "2024-02-12T10:32:53.456Z",
      "traceId": "dff73372-d6a1-45df-9938-7081c510fec1"
    }
  ]
}

{
  "payload": [
    {
      "transactionReference": "5bbcbb4c-a657-4009-997c-fef9624c7405",
      "transactionStatus": 6,
      "transactionStatusDescription": "Rejected",
      "transactionLastUpdated": "2024-02-12T11:17:04.381Z",
      "traceId": "12e1d8f8-0b50-40bc-b0d2-b9337b37a231"
    }
  ]
}

Transaction Status Codes

Each transaction progresses through one of the following statuses:

Status Id	Status Name	Status Description
1	Received	The transaction has been submitted by the client to MiFinity
2	Internal Error	MiFinity failed to initiate the transaction
3	Submitted	The transaction has been received by MiFinity
5	Processed by acquirer	The transaction has been processed successfully
6	Rejected	The transaction has been rejected by MiFinity
7	In Progress	The transaction is being reviewed by MiFinity
8	On Hold KYC	Additional KYC checks are being performed on the transaction

✅
A transactionStatus of 5 (Processed by acquirer) indicates the transaction completed successfully.