API ReferenceIntegrationsKnowledge Base

Add Receiver to an Existing Virtual Account

You can update a virtual account by adding a receiver for it. For example, if you had created a virtual account with only a bank account receiver earlier, you can now add a VPA receiver to it. Similarly, if you had created a virtual account with a VPA receiver, you can add a bank account receiver.

Note:
If you had created a virtual account with a receiver, for example, bank account, you cannot add another bank account receiver or replace it. Similarly, if you had created a virtual account with only a VPA receiver, you cannot replace or update it.

/virtual_accounts/:id/receivers

Path Parameter🔗

id mandatory
string The unique identifier of the virtual account to which another receiver type is to be added.

Request Parameters🔗

types mandatory

array The receiver type to be added to the virtual account. Possible values are:

  • bank_account
  • vpa
vpa optional

json object Descriptor details for the virtual UPI ID. This is to be passed only when vpa is passed as the receiver types.

descriptor
string You can provide a custom descriptor for the UPI ID. This is a unique identifier provided by you to identify the customer. For example, gaurikumar and akashkumar are the descriptors in the usernames rpy.payto00000gaurikumar and rpy.payto00000akashkumar respectively. The combination of merchant prefix and descriptor must be 20 characters. The length of the merchant prefix can vary between 4-10 characters, and the length of descriptor from 10-16 characters.
‹›
×