Sign in

v1

latestOpenAPI 3.1.02026-07-2418201.6 MB

Create Virtual Account

This API is an updated version of creating a virtual account on Decentro's v3 stack.

post/v3/banking/account/virtual

Headers

client_idstring required

Decentro assigned client_id during onboarding.

client_secretstring required

Decentro assigned client_secret during on boarding.

x_on_behalf_ofstring

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

Request body

reference_idstring required

A unique ID assigned by clients for every API request.

consumer_urnstring required

A unique identifier assigned to each merchant by Decentro during Onboarding

namestring

Virtual account holder name to be put against the account.

customer_va_identifierstring required

Unique customer identifier to be saved against the virtual account.

custom_va_numberstring

custom virtual account suffix as requested by the platform. If not passed, Decentro creates a VA number at its end.

block_va_auto_settlementstring

This flag, if set of true, will not settle the balances held in this virtual account to the settlement account. Default - False

Response

200

OR

Example response

{
  "decentro_txn_id": "E3335083304D418FA8E340BE63CB29B5",
  "api_status": "SUCCESS",
  "message": "Virtual accounts created successfully.",
  "data": {
    "account_details": [
      {
        "custom_va_number": "000054321",
        "virtual_account_number": "4625250000054321",
        "virtual_account_ifsc": "YESB0CMSNOC",
        "virtual_account_status": "ACTIVE",
        "transfer_type_enabled": [
          "IMPS"
        ]
      }
    ]
  },
  "response_key": "success_virtual_account_created"
}