v1

latestOpenAPI 3.1.02026-07-2418201.6 MB

Update virtual account

put/v2/banking/account/virtual/{VA_Number}

Path parameters

VA_Numberstring required

The account number of the virtual account which client wants to update.

Headers

client_idstring

client_secretstring

module_secretstring

provider_secretstring

Request body

actionstring

Default value to be passed by clients: "update"

emailstring

To be passed if the email id associated with the virtual account needs to be updated.

mobilestring

To be passed if the mobile number associated with the virtual account needs to be updated.

addressstring

To be passed if the address associated with the virtual account needs to be updated.

kyc_verifiedstring

To be passed if the KYC verification status associated with the virtual account needs to be updated.

customer_idstring

To be passed if the customer id associated with the virtual account needs to be updated.

virtual_account_balance_settlementstring

To be passed if the VA settlement configuration associated with the virtual account needs to be updated.

generate_static_qrstring

To be passed if the Static QR code associated with the virtual account needs to be updated or fetched again.

namestring required

Virtual account holder name to be put against the account.

panstring required

PAN number of the virtual account holder..

is_activeboolean

To be passed if the Virtual Account needs to be deactivated or reactivated.

Response

200

decentroTxnIdstring

statusstring

responseCodestring

messagestring

Example response

{
  "decentroTxnId": "F5989F01D6A5446E83CA0EB5FD59CA79",
  "status": "SUCCESS",
  "responseCode": "S00000",
  "message": "Virtual accounts created successfully",
  "data": [
    {
      "bank": "YES BANK LTD",
      "status": "success",
      "message": "YES Bank account created successfully.",
      "accountNumber": "500500603683277108",
      "ifsc": "YESB0CMSNOC",
      "allowedMethods": [
        "IMPS"
      ],
      "currency": "INR",
      "upiQrCode": "iVBORw0KGgoAAAANSUhEUgAAATEAAAExAQAAAAA8HqjFAAAD1ElEQVR4nO2aTW6rUAyFjRgwZAnshG4MCSQ2RnbCEjJkgHDPOYaWKJMOr9VkgBL4+iQ/28c/F/M/fSb7cB/uf3JPM6t4+fId13bvrG/nFZe98wV3miTc6P54WtccNnTg5hU/B2sefPqAsVk43iO3tL760c4OG0dd1vgHEnF0WYVvct7W8y9wr2vScbNv4npjJNKXeNq921swp/gb12axwTa6rOHPrYK973FaMCc9GOij98ubbpTL6fOskTjt1MF5SKGe377gxjcdL5nbpQfMnnmFuMHAw+oVGUVlaPcfewvn4J6tV9TRssVqBtwOe51G3/W5cC5SqNuM0swqaXSZ5Jrx13kOjn5DMtHogT6Cwhn8hoqjNgDlMwtHGcYDD1WeXXLdMLecvUASjvLFau9LOymZHC6bop2RGDRJOOvURdLAVU8pCp2FwsF1noRDHjEIN5OkwWg1MdJs5VYSDvEne1HoLz2oWHZOuR4sCcf4o00okCg2XyFz7L4o3K86XjRHXdMD9o6bLO8Vf059RkZ5Dg5mSb7A1TK6UxCGrr3qRtEczNKIAkmb6LdLD/gz2pk8HHquVRkFl8Hont3XwTn+aF/sLZlD4jj7F81W0VQuYS/koTonrwQcx0M6Ck9Hlwoge1g+2c7c/18K51AltXvYrgWEaWIxShq//+hz+dzZTyrgaPTBJv/QiPKsb/aWzaGwPLRSARwKp3Yf5ZMP6tVzcFcPrNqolUp0XzL67G5ScBxHYuC91hPGDWR1xt+trpbN+Rq7B9ZLKbUmYfVhkusmC8dVnannii0250YOK7sGmJ/4K51TeVcyjbQXMHVNsyTn318dL5uLeUuD4sjpfYr1tvZDsZzPw3GBHY0XHnRX/L32YaVzauNhKqcsdDLnJMyxnqEXzXEGLlJI2TO6vikStSSi4OXhLNpGHZYo6pYY5j02kEm46Cd5oEB4idZ+0pyCi/3Wy9I5j2O2694cTaVm+5gqk3B73KMKSBS6mN5Pzf7Nt8K5Z30tGtsQ5DDQeG7V3OwtneN2S/MvF/HReDEIpc/asDQ5uCjvEul61amChmAptQZKz8FJD1otu863BGLjxTaZ+9MX3SiZkx7UetshDkARehP9dvb3aTjXEYn0QKWSWwhZee7qc3Cql64ttorNEEqtI6sXXSudG1nyaRuFjPsIrYDPRfd93i+c0/s0Y8y/XEqcyRTniPfzhSRcpRIjRwHW5eVcKAVX88UTve3AzQTX2xSF7XqzJgOn+OPpuk6wTG9ATEyrcxDLwkkPtJQYY9nFKmk65tVLNUm4v3w+3If7l9w3APwE1r4nVJsAAAAASUVORK5CYII=",
      "upiOnboardingStatus": "PENDING",
      "upiOnboardingStatusDescription": "Not valid for Static QR generation.",
      "virtualAccountBalanceSettlement": "ENABLED",
      "upiStaticQrGenerationStatus": "SUCCESS",
      "upiStaticQrGenerationStatusDescription": "UPI Static QR generated successfully."
    }
  ]
}