Bills3

Customers4

Disputes4

Documents3

Instant Settlements3

Invoices8

Items5

Linked Accounts8

Orders5

Partner Accounts1

Partner Documents4

Partner Stakeholders1

Partner Webhooks5

Payment Downtimes2

Payment Links6

Payments4

Plans3

QR Codes6

Refunds6

Settlements3

Subscriptions10

Transfers8

Virtual Accounts10

X Account Validation3

X Banking Balances1

X Contacts4

X Fund Accounts4

X Payout Links4

X Payouts6

X Transactions2

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

Request

Base URL
https://api.razorpay.com/v1
Auth
- HTTP basic
- or OAuth 2
  Authorization codehttps://mcp.razorpay.com/authorize
  Client credentials
  Token URLhttps://mcp.razorpay.com/token
  Scopesread_only
TypeScript
https://skmtc.dev/razorpay/apis/razorpay-api/docs/virtual_accounts/:va_id/allowed_payers/post.ts
A function with typed inputs. Its response is checked against the schema.

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

Changes

No recorded changes to this operation across all 1 revision of this API.