> ## Documentation Index
> Fetch the complete documentation index at: https://razorpay-881012b3.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# Create a VPA and Link to Payment Source
> Create a VPA and link it to the payment source using the Razorpay TPAP Pro API.
Available in
🇮🇳 India
If not already linked, create a VPA and link it with a list of payment sources. The expansion in the request URL returns the expanded payment source if it is passed in the query parameters. Use this endpoint to create a VPA and link it to a payment source.
```bash Curl theme={null}
curl -X POST 'api.rzp..com/v1/upi/tpap/vpa/link?expand[]=fundsources' \
-u [YOUR_KEY_ID]:[YOUR_SECRET] \
-H "Content-type: application/json" \
-H "x-device-fingerprint: " \
-H "x-device-fingerprint-timestamp: 1496918882000" \
-H "x-customer-reference: customer-id-from-customer" \
-d '{
"vpa":"customer@handle",
"fundsources":[
{
"fundsource_id":"fs_1234",
"primary":true
}
]
}'
```
```json Response theme={null}
{
"entity":"upi.vpa",
"customer_reference":"cust_1234",
"mobile":"999999999",
"address":"kunal-1@rzpa",
"status":"active",
"fundsources":{
"entity":"collection",
"count":2,
"items":[
{
"id":"fs_1234",
"customer_name":"kunal1",
"masked_account_number":"xxxxxx8990",
"account_reference_number":"999988126236990",
"type":"savings",
"ifsc":"SBI00001",
"upi_pin_set":true,
"upi_pin_length":4,
"otp_length":4,
"atm_pin_length":6,
"fundsource_provider":{
"name":"HDFC Bank",
"upi_iin":"600007",
"upi_enabled":false,
"mobile_registration_format":"format1",
"logo_url":""
},
"primary":true
},
{
"id":"dummyfs1111111",
"customer_name":"kunal1",
"masked_account_number":"xxxxxx8990",
"account_reference_number":"999988126236990",
"type":"savings",
"ifsc":"SBI00001",
"upi_pin_set":true,
"upi_pin_length":4,
"otp_length":4,
"atm_pin_length":6,
"fundsource_provider":{
"name":"HDFC Bank",
"upi_iin":"600007",
"upi_enabled":false,
"mobile_registration_format":"format1",
"logo_url":""
}
}
]
}
}
```
## Request Parameters
The VPA that should be linked.
The list of payment sources that should be linked with the requested VPA.
The payment source identifier.
The field to set the given VPA payment source link as primary.
* `true`: VPA is linked to the payment source.
* `false`: VPA is not linked to the payment source.
## Response Parameters
The name of the entity. Here, it is `upi.vpa`.
The customer identifier. You must pass the customer identifier at the TPAP end in this attribute.
The mobile number of the VPA linked to the payment source.
The VPA of the customer.
The VPA and payment source linking status. Possible values:
* `active`
* `inactive`
Collection of payment sources.
Indicates the name of the entity.
Indicates the number of items in the entity type.
Payment source and payment source provider details.
Indicates whether VPA payment source is linked primary.
* `true`: VPA is linked to the payment source.
* `false`: VPA is not linked to the payment source.
Unique identifier of the payment source.
Customer name.
Masked account number of the payment source.
The account reference number.
Type of the payment source. Possible values:
* `savings`
* `current`
* `non resident ordinary`
* `non resident ordinary`
* `secured overdraft`
* `credit`
* `ppi`
IFSC of the bank.
Indicates whether UPI PIN is set for payment source. Possible values:
* `true`: UPI PIN is set.
* `false`: UPI PIN is not set.
Length of the UPI PIN of the payment source allowed.
Length of the OTP PIN of the payment source allowed.
ATM PIN length of the payment source allowed.
Payment source provider details.
UPI Issuer Identification Numbers (iin) of the payment source provider issued by NPCI.
Name of the payment source (bank account) provider.
Indicates whether UPI is enabled to the payment source provider. Possible values:
* `true`: UPI is enabled.
* `false`: UPI is not enabled.
Indicates the format as defined by NPCI: `format1`, `format2` and so on.
Indicates the URL of the bank logo.