Get StartedExport API CollectionSupport

Account v1

Suggest Edits

With this API, you can perform the following -

  • Create virtual accounts for your customers/buyers/partners/sellers in real time with any of our partner banks.
  • Manage/Update the virtual accounts in terms of limits and the personal details linked to each of those accounts.

👍

Decentro Update

Decentro is now live with v2, a more optimized version of creating virtual accounts with better performance. v1 APIs will no longer be supported.

Create a Virtual Account

This API allows you to create a virtual account for a consumer or business in real-time. This functions exactly like a regular bank account with the exception of cash withdrawals. You can use the Virtual account to collect funds, hold funds or settle the same to a beneficiary or multiple beneficiaries.

You can also choose the underlying bank provider if you have a particular preference.

UPI Transaction Limit

BankUpper Limit Per Transaction (INR)Per Day Transaction Limit (INR)
Yes Bank*1,00,00010,00,000

Please note that some banks from which the funds are being transferred have lower daily limits for UPI.

Sample API

curl --location --request POST 'https://in.staging.decentro.tech/core_banking/account_linking/create_virtual_account' \
--header 'client_id: <YOUR_CLIENT_ID>' \
--header 'client_secret: <YOUR_CLIENT_SECRET>' \
--header 'module_secret: <YOUR_CORE_BANKING_MODULE_SECRET>' \
--header 'provider_secret: <YOUR_CHOSEN_PROVIDER_SECRET>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "type": "virtual",
    "name": "somefirst somelast",
    "pan_number": "ABCDE1234F",
    "email_address": "[email protected]",
    "mobile_number": "9999999999",
    "address": "some_physical_address",
    "kyc_verified": 1,
    "kyc_check_decentro": 0,
    "transaction_limit": "10000",
    "currency_code": "INR",
    "customer_id": "DEC0001",
    "virtual_account_balance_settlement": "enabled"
}'

{
  "status": "success",
  "accountNumber": "462515XXXXXXXXXXXX",
  "ifscCode": "YESBXXXXXXX",
  "currency": "INR",
  "allowedMethods": [
    "neft",
    "imps",
    "rtgs",
    "upi"
  ],
  "transactionLimit": 100000,
  "minimumBalance": 0,
  "upiId": "462515XXXXXXXXXXXX@yesbankltd",
  "upiQrCode": "<Base64 string for the QR>",
  "virtualAccountBalanceSettlement": "ENABLED",
  "decentroTxnId": "62E67XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
}

Manage Account

This API allows you to manage/update an existing account for your consumers/businesses in real-time. Use this API to update the details of a Virtual account created.

curl --location --request PUT 'https://in.staging.decentro.tech/core_banking/account_linking/manage_virtual_account' \
--header 'client_id: <YOUR_CLIENT_ID>' \
--header 'client_secret: <YOUR_CLIENT_SECRET>' \
--header 'module_secret: <YOUR_CORE_BANKING_MODULE_SECRET>' \
--header 'provider_secret: <YOUR_CHOSEN_PROVIDER_SECRET>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "action": "update",
    "account_number": "462515XXXXXXXXXXXX",
    "type": "virtual",
    "name": "John Doe",
    "email": "[email protected]",
    "mobile_number": "9898989898",
    "address": "7y, bnbnfdf, street C, Delhi- 110089",
    "kyc_verified": "0",
    "kyc_check_decentro": "0",
    "transaction_limit": "1000000",
    "customer_id": "DEC0001"
}'

{
  "status": "success",
  "accountNumber": "462515XXXXXXXXXXXX",
  "ifscCode": "YESBXXXXXXXX",
  "allowedMethods": [
    "neft",
    "imps",
    "rtgs",
    "upi"
  ],
  "upiId": "462515XXXXXXXXXXXX@yesbankltd",
  "transactionAmountLimit": 1000000,
  "minimumBalance": 0,
  "decentroTxnId": "4EAD1XXXXXXXXXXXXXXXXXXXXXXXXXXX"
}

Updated 6 months ago