Skip to main content
POST
Create a virtual account

Body Parameters

Example Request

Response

Returns the newly created virtual account with bank details.
When the customer transfers the exact amount to the virtual account, the linked invoice is automatically marked as paid. Partial payments update amount_received but do not close the invoice.
Virtual accounts expire after 30 days by default. After expiry, any transfer to the account will be returned to the sender.

Authorizations

Authorization
string
header
required

Tenant API key obtained from POST /auth/register or POST /v1/developer/keys.

Body

application/json
customer_id
string<uuid>
required
amount
integer<int64>
required

Expected amount in the lowest currency unit.

invoice_id
string<uuid>

Response

Virtual account created.

id
string<uuid>
tenant_id
string<uuid>
customer_id
string<uuid>
invoice_id
string<uuid> | null
account_number
string
ifsc_code
string
bank_name
string
beneficiary_name
string
razorpay_va_id
string
status
string
amount_expected
integer<int64>
amount_received
integer<int64>
closed_at
string<date-time> | null
created_at
string<date-time>