Query Intrabank Transfer To Virtual Account Status

Returns the real outcome of a transfer made with POST /core/transfer/va, including whether the virtual account credit landed.

GET /core/transfer/va/query/{transactionReference}

Path Parameter

Field Name	Type	Required	Description
transactionReference	string	TRUE	The `transactionReference` sent on the original transfer

Query Parameters

Field Name	Type	Required	Description
sourceAccountNUBAN	string	TRUE	The source account of the original transfer. A reference is unique per source account

Response

Field Name	Type	Description
transactionReference	string	The reference queried
status	string	`IN_PROGRESS`, `SUCCESSFUL`, `FAILED`, `PENDING_APPROVAL`, `CREDIT_FAILED` or `UNKNOWN`
transactionID	integer	Transfer ID, once one exists
amount	number	Amount
failureReason	string	Why a transfer failed or went stale
createdDate	string	`yyyy-MM-dd'T'HH:mm:ss`
updatedDate	string	`yyyy-MM-dd'T'HH:mm:ss`

A 404 means the reference was never received for that account, so it is safe to re-send. After a timeout or 5xx, query first and re-send only if the status allows it.

OAuth 2.0

Client Credentials

Add the parameter

Authorization

to Headers，whose value is to concatenate the Token after the Bearer.

Example:

Authorization: Bearer ********************

Token URL: {{tpGatewayHostUrl}}/security/authenticate

Responses

🟢200Success

application/json

Success

Bodyapplication/json

Example

{
  "transactionReference": "INTRA-REF-0001",
  "status": "SUCCESSFUL",
  "transactionID": 4,
  "amount": 1500.0,
  "createdDate": "2026-01-15T10:30:00",
  "updatedDate": "2026-01-15T10:30:01"
}

🟠400| Source | Error | When |

🟠401| Source | Error | When |

🟠404| Source | Error | When |

🔴500| Source | Error | When |

Query Intrabank Transfer To Virtual Account Status