Transaction Status (PAYC)
Retrieve the transaction status using both traceID and transactionReference.
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"
}
]
}GET /api/transactions/{transactionReference}/status
| Parameter | Type | In | Description |
|---|---|---|---|
transactionReference | string | path | Unique identifier for the transaction |
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"
}
]
}{
"errors": [
{
"type": "FATAL",
"errorCode": "ELEMENT_NOT_FOUND",
"message": "No transaction found for reference: 64ec6629-5a4e-436f-9eca-62c270406d4b.",
"field": "64ec6629-5a4e-436f-9eca-62c270406d4b"
}
]
}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.
Updated 7 days ago
What’s Next
Did this page help you?