Intrabank Transfer Query

Returns the real outcome of a virtual account intrabank transfer (POST /transfer/intra or POST /transfer/intra/collection-accounts) from the transactionReference that was sent with it. Use it after a timeout or an error response instead of sending the transfer again.

GET /transfer/intra/query/{transactionReference}?fromAccountID={fromAccountID}

Path Parameter

Field Name	Type	Required	Description
transactionReference	string	TRUE	The reference that was sent with the transfer.

Query Parameters

Field Name	Type	Required	Description
fromAccountID	string	TRUE	The account the transfer was debited from. A reference is unique per source account.

Response

Field Name	Type	Description
transactionReference	string	The reference you sent.
status	string	`IN_PROGRESS`, `SUCCESSFUL`, `FAILED`, `REVERSED` or `UNKNOWN`.
transactionID	string	Reference of the credit entry. Only present when `status` is `SUCCESSFUL`.
amount	decimal	The amount of the transfer.
failureReason	string	Why the transfer did not complete. Absent when there is none.
createdDate	string	When the transfer was received (`yyyy-MM-dd'T'HH:mm:ss`).
updatedDate	string	When the status last changed (`yyyy-MM-dd'T'HH:mm:ss`).

Status	Meaning	What to do
IN_PROGRESS	The transfer is still running.	Query again. Do not send it again.
SUCCESSFUL	The transfer completed.	Nothing.
FAILED	Nothing moved.	You may send it again with the same reference.
REVERSED	The debit was taken, the credit failed and the debit was returned.	Treat as not paid.
UNKNOWN	The outcome could not be determined.	Reconcile. Do not send it again.

A 404 means the reference was never received for that account.

Responses

🟢200Success

application/json

Success

Bodyapplication/json

Example

{
  "transactionReference": "NG-900929102",
  "status": "SUCCESSFUL",
  "transactionID": "NG-900929102-SL-TRSF-CRDT",
  "amount": 7.0,
  "createdDate": "2026-10-30T10:15:30",
  "updatedDate": "2026-10-30T10:15:31"
}

🟠400| Source | Error | When |

🟠401| Source | Error | When |

🟠404| Source | Error | When |

Intrabank Transfer Query