GuidesAPI ReferenceChangelog
API Reference

Retrieve Virtual Account

Get the bank details a payer needs to send funds to a customer.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

Retrieve a virtual account when you need to show its payment details or check whether it is ready to use. Pass the virtual_account_id returned by create or list.

Receiving payments: When status is ACTIVE, choose the payer's network from networks. These are the details to give the payer:

FieldWhat to show
account_identifierThe receiving account identifier.
institution_identifierThe bank routing identifier, when provided.
bankThe receiving bank's name and address.
account_holderThe beneficiary's name and address. Use these details on the transfer.
memoThe payment reference, when provided. Ask the payer to copy it exactly.

Keep account and institution identifiers as strings so leading zeros are preserved. If several entries use the same network, keep their instructions separate. Use only the networks returned for this account.

Availability: PENDING, DEACTIVE, and FAILED accounts return an empty networks array. Fetch the account again before displaying bank details, since instructions and availability can change. Updates from the bank may take time to appear.

Path Params
string
required

Account ID (BZ-/IN-) or legacy customer UUID

string
required

Virtual account ID in VA-XXXX-XXXX format

Responses

Language
Credentials
Bearer
OneMoney-HMAC-SHA256
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json