Transaction Status
You can retrieve the transaction status using both traceID and transactionReferecnce.
Check the status of any transaction using its traceID or transactionReference.
Important: Only treat HTTP 200 (Transaction found) and 404 (Transaction not found) as valid responses. Retry any 5xx responses — do not assume a transaction is missing based on a server error. The transactionReference field may be empty if the reference has not yet been created on MiFinity's end.
Retrieve Transaction Status
GET /api/transactions/status/{traceID}
| Parameter | Type | In | Description |
|---|---|---|---|
traceID | string | path | Unique identifier for the transaction |
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"
}
]
}Transaction Status Codes
Each transaction progresses through one of the following statuses:
| Status Id | Status Name | 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
transactionStatusof 5 (Processed by acquirer) indicates the transaction completed successfully.