Fetch Virtual Account Details

Fetch Virtual Account by Reference

Get the details of a virtual account using the reference you supplied when creating it.

Endpoint: GET https://api.budpay.com/api/v2/collection/virtual-account/:reference

Parameters

This section details the header information required for fetching a virtual account by reference.

Field Name	Description
URL	`https://api.budpay.com/api/v2/collection/virtual-account/:reference`
Method	`GET`
Authorization	`Bearer YOUR_SECRET_KEY` (Replace with your actual BudPay secret key)

Path Parameters

Parameter	Type	Required	Description
`reference`	String	Yes	Reference supplied when the virtual account was created

Sample Request

Endpoint: GET https://api.budpay.com/api/v2/collection/virtual-account/2026e3431VA0000001

1curl -X GET 'https://api.budpay.com/api/v2/collection/virtual-account/2026e3431VA0000001' \2  -H 'Authorization: Bearer YOUR_SECRET_KEY'

{  "status": true,  "message": "Virtual Account List Retrieved",  "data": {    "accountNumber": "9888145123",    "accountName": "Test Customer Surname",    "bankCode": "000027",    "bankName": "Globus Bank",    "accountType": "reserved",    "accountStatus": "active",    "expiryInMinutes": 0,    "reference": "2026e3431VA0000001",    "createdAt": "2026-10-21T16:29:02"  }}

Response Fields

Field	Description
`accountNumber`	Virtual account number
`accountName`	Name on the virtual account
`bankCode`	Code of the partner bank
`bankName`	Name of the partner bank
`accountType`	`reserved` or `checkout`
`accountStatus`	Account status (e.g. `active`)
`expiryInMinutes`	Minutes until the account expires (`0` for reserved accounts)
`reference`	Reference supplied at creation
`createdAt`	Time the account was created (UTC)

Create Virtual Account Fetch by Account Number