Skip to main content

Transaction Status Check

Overview

Retrieve the current status of a specific transaction using its reference.


Endpoint

POST /waas/Transaction/transactionStatusCheck

Request Headers

KeyValueRequired
AuthorizationYour client-specific secret keyYes
Ocp-Apim-Subscription-KeyYour access subscription keyYes
Content-Typeapplication/jsonYes

Request Parameters

ParameterTypeRequiredDescription
tran_referencestring (query)YesTransaction reference (msgId)

Request Example

curl -X POST "https://api-sandbox.accessbankplc.com/waas/Transaction/transactionStatusCheck?tran_reference=TXN-20250211-001" \
-H "Authorization: Bearer <access_token>" \
-H "Ocp-Apim-Subscription-Key: <subscription_key>" \
-H "Content-Type: application/json"

Response

{
"succeeded": true,
"code": "200",
"message": "successful request",
"data": {
"transactionRef": "TXN-20250211-001",
"status": "SUCCESS",
"amount": 5000.00,
"debitAccount": "0702334455",
"creditAccount": "0702334466",
"timestamp": "2025-02-11T10:30:00Z"
},
"pageMeta": {}
}

Status Values

StatusDescription
SUCCESSTransaction completed
PENDINGProcessing
FAILEDTransaction failed