Virtual Account Services
  1. Transaction
Virtual Account Services
  • Introduction
  • Terminologies
  • Webhooks
  • Authentication
  • Account
    • Create Account
      POST
    • Rename Account
      POST
    • Balance Inquiry
      GET
    • Create Bulk Accounts
      POST
    • List Accounts
      GET
  • Transaction
    • Credit Account
      POST
    • Debit Account
      POST
    • Credit Account [Agency Banking]
      POST
    • Debit Account [Agency Banking]
      POST
    • Transaction Query
      GET
    • Transaction Details
      GET
    • Transaction History
      GET
  • Transfer
    • Get Institutions
      GET
    • Name Inquiry
      POST
    • Interbank Transfer
      POST
    • Interbank Transfer [Sync]
      POST
    • Transfer Query
      GET
    • Transfer Enquiry
      GET
    • Virtual Account Intrabank Transfer
      POST
    • Core Banking Intrabank Transfer
      POST
    • Collection Accounts Intrabank Transfer
      POST
  • Invoice
    • Create Invoice
      POST
    • Get Invoice Detail
      GET
    • List Merchant Invoices
      GET
  • Refunds
    • Initiate Refund
    • Get Refund Status
    • Get Refunds
  • Notifications
    • Notification
    • Send Notification
  • Merchant
    • Account
      • Get Account
      • Activate Sub Ledger For Merchant
      • Get SubLedger Callback Urls
      • Set SubLedger Callback Urls
      • Get Collection Accounts
    • Transfer
      • Get Transfer History
      • Get Subledger transfers
      • Get Transfer Details
      • Name Inquiry
    • Refund
      • Refund Details
  • Admin
    • Accounting
      • Get GL Accounts
      • Get Classification Codes
    • Dashboard
      • Dashboard Summary
      • Dashboard Transactions
      • Dashboard Transaction Details
    • Group Codes
      • Get Group Codes
      • Set Collection Account
      • Create Group Code
    • Reporting
      • Get Report Types
      • Get Report Parameters
      • Create Report
      • Get Reports
      • Get Reports Details
  1. Transaction

Transaction Details

GET
/transaction/details/{transactionID}
This API retrieves transaction details of an interbank transferusing a unique transactionID. The response provides comprehensive details about the transaction.

Path Variable#

Field NameTypeRequiredDescription
transactionIDstringTRUEThe unique reference identifier for the transaction whose status is being queried.

Query Params#

Field NameTypeRequiredDescription
inwardstringFALSEAn optional field, included only if the transaction is inward.

Response Body#

Field NameTypeDescription
sourceInstitutionCodestringCode representing the institution that initiated the transaction.
destinationInstitutionCodestringCode representing the institution receiving the transaction.
sourceBankNamestringThe name of the bank from which the transaction originated.
sourceAccountNamestringThe name associated with the source account.
sourceAccountNUBANstringThe NUBAN (account number) for the source account.
destinationBankNamestringThe name of the bank receiving the transaction. (May be null for inward transactions.)
destinationAccountNamestringThe name associated with the destination account.
destinationAccountNUBANstringThe NUBAN (account number) for the destination account.
amountdecimalThe amount involved in the transaction.
narrationstringA brief description or note regarding the transaction.
classificationCodestringCode indicating the classification or type of the transaction. (null for inward transactions.)
transactionStatusstringThe current status of the transaction (e.g., UNRESOLVED, CONFIRMED, FAILED).
traceIDstringA unique identifier used for tracking the transaction. (May be null if not available.)
transactionReferencestringThe unique reference identifier for the transaction.

Notes:#

Inward Transactions: The destinationBankName and classificationCode may be null.
Outward Transactions: The classificationCode provides additional details on transaction type.

Request

Path Params

Query Params

Request samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET '/transaction/details/000007240124121218889203393491?inward=true'

Responses

🟢200Outward
application/json
Body

Example
{
    "sourceInstitutionCode": "090605",
    "destinationInstitutionCode": "000013",
    "sourceBankName": "Madobi Microfinance Bank",
    "sourceAccountName": "iRecharge",
    "sourceAccountNUBAN": "9900000839",
    "destinationBankName": "GUARANTY TRUST BANK PLC",
    "destinationAccountName": "JOSEPH SAMUEL OLUWASEUN",
    "destinationAccountNUBAN": "0021459404",
    "amount": 1000,
    "narration": "iRecharge",
    "classificationCode": "NIP0001_DEBIT",
    "transactionStatus": "UNRESOLVED",
    "traceID": null,
    "transactionReference": "090605240123164925947709536560"
}
🟢200Inward
🟢200Inward Copy
Modified at 2025-03-17 22:01:31
Previous
Transaction Query
Next
Transaction History
Built with