Transfer Enquiry

This operation retrieves the status of a transfer by specifying the transactionID, providing real-time updates on whether the transfer is successful, pending, or failed.

Path Parameter

Field Name	Type	Required	Description
transactionID	string	true	The unique identifier of the transaction

Response Body

Response Table

Field Name	Type	Description
id	integer	A unique identifier for the transaction record.
destinationInstitutionCode	string	The unique code identifying the recipient's financial institution.
destinationBankName	string	The name of the recipient's financial institution.
destinationAccountName	string	The name of the recipient's account holder.
destinationAccountNUBAN	string	The NUBAN (Bank Account Number) of the recipient's account.
amount	integer	The amount transferred in the transaction.
narration	string	A brief description or purpose of the transaction.
transactionDate	string	The date and time the transaction was initiated.
transactionID	string	A unique reference ID assigned to the transaction.
sessionID	string	A unique identifier for the transaction session.
transactionStatus	string	The current status of the transaction (e.g., PENDING, SUBMITTED, CONFIRMED).
createdDate	string	The date and time the transaction record was created.

The transactionStatus can be either of these below:

Status	Description
`SUBMITTED`	Transaction Submitted but not approved
`AUTHORIZED`	Transaction Authorized and transfer initiated
`SENT_TO_GATEWAY_SUCCESS`	Transfer Sent Successfully But Not Confirmed By NIBSS and Receiving Institution yet
`SENT_TO_GATEWAY_ERROR`	Error Sending Transfer through NIBSS to Receiving Institution
`PENDING`	Transaction is still processing
`UNRESOLVED`	Failed In Sending Transfer, Needs Resolution
`REJECTED`	Transfer Rejected By Admin
`CONFIRMED`	Transaction confirmed by NIBSS And Receiving Institution

Responses

🟢200Transfer Enquiry

application/json

Body

Example

{
    "id": 287,
    "destinationInstitutionCode": "000014",
    "destinationBankName": "ACCESS BANK PLC",
    "destinationAccountName": "MOHAMMED WAZIRI IDRISA",
    "destinationAccountNUBAN": "0075047718",
    "amount": 9000,
    "narration": "iRecharge",
    "transactionDate": "2023-10-27T00:00:00.000+00:00",
    "transactionID": "090605231027024654124508683355",
    "sessionID": "999999231027024654177035507679",
    "transactionStatus": "CONFIRMED",
    "createdDate": "2023-10-27T01:46:48.000+00:00"
}

Path Parameter

Response Body

Response Table

Request

Request samples

Responses

Transfer Enquiry

Path Parameter#

Response Body#

Response Table#

Request

Request samples

Responses

Path Parameter

Response Body

Response Table