Get Virtual Account Detail

This API allows clients to fetch the details of their virtual accounts with Decentro

Overview

The Get Virtual Accounts API allows clients of Decentro to retrieve detailed information about all virtual accounts (VAs) created within the Decentro platform. This API is essential for clients who need to manage their virtual accounts effectively, enabling them to access account details across various bank providers in a streamlined manner.

Flow

  1. Clients create multiple virtual accounts using Decentro's services for various fund flows.
  2. Clients utilize the Get Virtual Accounts API to fetch details of all virtual accounts associated with their account.

Managing family of virtual accounts

Clients can easily manage fetching virtual account details by selecting from either a single virtual account, a family of virtual accounts, or all virtual accounts associated with a consumer.

To effectively identify the relevant virtual accounts, clients can use one of the following identifiers::

IdentifierResults
virtual_account_numberThe details will be fetched against the specific virtual_account_number in question.
custom_va_numberThe details will be fetched for all virtual account numbers across various banks linked to the specified custom VA number.
customer_va_identifierThe details will be fetched for all virtual account numbers across different banks associated with the given customer VA identifier.
consumer_urnThe details will be fetched for all virtual accounts across banks created for the consumer.
Query Params
string

A unique identifier assigned to each merchant by Decentro during Onboarding

string
required

The page number for viewing the virtual account details. Should be a valid positive integer.

string

Virtual account number as requested by the platform.

string

The suffix part of the VA that uniquely identifies each VA. It can be from 6 -10 digit. Eg: va_suffix will be 000001 for virtual account number 46525000001

string

Unique customer identifier that is mapped against the virtual account.

Headers
string

Decentro assigned client_id during onboarding.

string

Decentro assigned client_secret during onboarding.

string

Optional header that allows parent merchant to consume the API on behalf of sub-merchant.

Responses

Language
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json