Transactions

Get a transaction by reference

Changed on

Retrieves the full transaction details including status, webhook delivery status, and timestamps.

get/v1/transactions/{reference}

Request

Path parameters

referencestring required

Transaction reference (e.g. TXN-16820000-AB1C2D3E)

Response

Transaction found

successboolean
messagestring
errorCodestring
errorsstring[]
timestampstring date-time

Example response

{
  "data": {
    "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "reference": "TXN-16820000-AB1C2D3E",
    "senderTag": "@alice",
    "senderAppName": "WalletApp",
    "receiverTag": "@bob",
    "receiverAppName": "PaymentsApp",
    "amount": 1500,
    "currency": "NGN",
    "status": "AWAITING_ACCEPTANCE",
    "narration": "School fees payment",
    "webhooks": [
      {
        "transactionReference": "TXN-16820000-AB1C2D3E",
        "targetUrl": "https://app-b.example.com/webhooks/transactions",
        "eventType": "TRANSACTION_INITIATED"
      }
    ]
  }
}

Changes

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status