Sign in

v1

latestOpenAPI 3.1.02026-07-2418201.6 MB

Get Virtual Account Detail

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

get/v3/banking/account/virtual

Query parameters

consumer_urnstring

A unique identifier assigned to each merchant by Decentro during Onboarding

pagestring required

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

virtual_account_numberstring

Virtual account number as requested by the platform.

custom_va_numberstring

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

customer_va_identifierstring

Unique customer identifier that is mapped against the virtual account.

Headers

client_idstring

Decentro assigned client_id during onboarding.

client_secretstring

Decentro assigned client_secret during onboarding.

x_on_behalf_ofstring

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

Response

200

OR

Example response

{
  "decentro_txn_id": "2110F0CD6FCC4722968688ABA787183C",
  "api_status": "SUCCESS",
  "message": "Virtual accounts retrieved successfully.",
  "data": {
    "virtual_accounts": [
      {
        "virtual_account_number": "4625250000004321",
        "custom_va_number": "00004321",
        "name": "test",
        "customer_va_identifier": "b3a26908-xxxxxxxx-ba65-6bc423c14772",
        "status": "ACTIVE",
        "va_created_on": "2025-01-10 12:31:20",
        "bank_provider": "YESB",
        "current_balance": 15000,
        "settlement_account_details": [
          {
            "settlement_account_urn": "E153669400D64D1AA28E97D25E6B9CC5",
            "account_number": "007881300004451",
            "account_ifsc": "YESB0000078"
          }
        ],
        "whitelisted_account_details": [
          {
            "account_number": "002281300011235",
            "account_ifsc": "YESB0000022",
            "remitter_relationship": "test demo 1"
          }
        ]
      }
    ],
    "page_count": 1,
    "total_page_count": 1,
    "total_count": 1
  }
}