v1

latestOpenAPI 3.0.0Proprietary2026-07-1313647393.0 KB

Virtual Accounts

Add an allowed payer (TPV)

Whitelist a specific payer bank account or VPA for a virtual account (Smart Collect with Third Party Validation). Only whitelisted payers can successfully pay into this virtual account.

post/virtual_accounts/{va_id}/allowed_payers

Path parameters

va_idstring required

Virtual Account ID (va_*).

Request body

type'bank_account' | 'vpa' required

Type of allowed payer.

Response

Allowed payer added.

idstring

Virtual account ID. Prefix: va_

namestring

Display name of the virtual account.

entity'virtual_account'

descriptionstring

Purpose or description of the virtual account.

amount_expectedinteger

Expected payment amount in paise. 0 means any amount is accepted.

amount_paidinteger

Total amount received so far in paise.

status'active' | 'closed'

active = accepting payments; closed = no longer accepting payments.

close_byinteger

Unix timestamp by which the account will auto-close. Maximum value: 2147483647.

closed_atinteger

Unix timestamp when the account was closed.

customer_idstring

Customer ID linked to this virtual account (cust_*).

notesNotes

Key-value pairs for storing custom metadata. Maximum 15 pairs. Each key and value must not exceed 256 characters.

created_atinteger