curl -u <YOUR_KEY>:<YOUR_SECRET> \
-X POST https://api.razorpay.com/v1/fund_accounts/validations \
-H "Content-Type: application/json" \
-d '{
"source_account_number": "7878780080316316",
"reference_id": "112233",
"notes": {
"random_key_1": "Make it so.",
"random_key_2": "Tea. Earl Grey. Hot."
},
"fund_account": {
"account_type":"vpa",
"vpa":{
"address":"gaurav.kumar@exampleupi"
}
"contact": {
"name":"Gaurav Kumar",
"email":"gaurav.kumar@example.com",
"contact":"9123456789",
"type":"employee",
"reference_id":"Acme Contact ID 12345",
"notes":{
"notes_key_1":"Tea, Earl Grey, Hot",
"notes_key_2":"Tea, Earl Grey... decaf."
}
}
}
}
}'
{
"id": "fav_00000000000001",
"entity": "fund_account.validation",
"status": "created",
"utr" : "123456789012",
"validation_results": {
"account_status": null,
"registered_name": null,
"details": null,
"name_match_score": null
},
"status_details": {
"description": "Validation request is created",
"source": "internal",
"reason": "validation_request_created"
},
"reference_id": "112233",
"notes": {
"random_key_1": "Make it so.",
"random_key_2": "Tea. Earl Grey. Hot."
},
"fund_account": {
"id": "fa_00000000000001",
"entity": "fund_account",
"account_type":"vpa",
"vpa":{
"address":"gaurav.kumar@exampleupi"
},
"active": true,
"created_at": 1567064019,
"contact": {
"id": "cont_00000000000001",
"entity": "contact",
"name":"Gaurav Kumar",
"email":"gaurav.kumar@example.com",
"contact":"9123456789",
"type":"employee",
"reference_id":"Acme Contact ID 12345",
"active": true,
"created_at": 1567064019,
"notes":{
"notes_key_1":"Tea, Earl Grey, Hot",
"notes_key_2":"Tea, Earl Grey... decaf."
}
}
}
}
{
"id": "fav_00000000000001",
"entity": "fund_account.validation",
"status": "completed",
"utr": "123456789012",
"validation_results": {
"account_status": "active",
"registered_name": "Gaurav Kumar",
"details": "The beneficiary account is valid.",
"name_match_score": 100,
"validated_account_type" : "bank account",
"bank_account": {
"bank_routing_code": "ICIC0000047",
"account_number": "1121431121541121",
"bank_name": "ICICI Bank",
"account_type": "saving"
}
},
"status_details": {
"description": "Validation request is completed",
"source": "beneficiary_bank",
"reason": "validation_completed"
},
"reference_id": "112233",
"notes": {
"random_key_1": "Make it so.",
"random_key_2": "Tea. Earl Grey. Hot."
},
"fund_account": {
"id": "fa_00000000000001",
"entity": "fund_account",
"account_type": "vpa",
"vpa": {
"address": "gaurav.kumar@exampleupi"
},
"active": true,
"created_at": 1567064019,
"contact": {
"id": "cont_00000000000001",
"entity": "contact",
"name": "Gaurav Kumar",
"email": "gaurav.kumar@example.com",
"contact": "9123456789",
"type": "employee",
"reference_id": "Acme Contact ID 12345",
"active": true,
"created_at": 1567064019,
"notes": {
"notes_key_1": "Tea, Earl Grey, Hot",
"notes_key_2": "Tea, Earl Grey... decaf."
}
}
}
}
{
"id": "fav_00000000000002",
"entity": "fund_account.validation",
"fund_account": {
"id": "fa_00000000000002",
"entity": "fund_account",
"contact_id": "cont_00000000000001",
"account_type": "vpa",
"vpa": {
"username": "gaurav.kumar",
"handle": "exampleupi",
"address": "gaurav.kumar@exampleupi"
},
"batch_id": null,
"active": true,
"created_at": 1573110860
},
"status": "failed",
"amount": null,
"currency": null,
"notes": {
"random_key_1": "Make it so.",
"random_key_2": "Tea. Earl Grey. Hot."
},
"validation_results": {
"account_status": "",
"registered_name": "",
"details": null,
"name_match_score": null,
"bank_account": {
"bank_name": null,
"ifsc": null,
"account_number": null,
"account_type": null
}
},
"created_at": 1574244676,
"utr": null
}
Validate a VPA
Create Contact, Fund account and validate Fund Account of type VPA via a single API.
POST
/
v1
/
fund_accounts
/
validations
curl -u <YOUR_KEY>:<YOUR_SECRET> \
-X POST https://api.razorpay.com/v1/fund_accounts/validations \
-H "Content-Type: application/json" \
-d '{
"source_account_number": "7878780080316316",
"reference_id": "112233",
"notes": {
"random_key_1": "Make it so.",
"random_key_2": "Tea. Earl Grey. Hot."
},
"fund_account": {
"account_type":"vpa",
"vpa":{
"address":"gaurav.kumar@exampleupi"
}
"contact": {
"name":"Gaurav Kumar",
"email":"gaurav.kumar@example.com",
"contact":"9123456789",
"type":"employee",
"reference_id":"Acme Contact ID 12345",
"notes":{
"notes_key_1":"Tea, Earl Grey, Hot",
"notes_key_2":"Tea, Earl Grey... decaf."
}
}
}
}
}'
{
"id": "fav_00000000000001",
"entity": "fund_account.validation",
"status": "created",
"utr" : "123456789012",
"validation_results": {
"account_status": null,
"registered_name": null,
"details": null,
"name_match_score": null
},
"status_details": {
"description": "Validation request is created",
"source": "internal",
"reason": "validation_request_created"
},
"reference_id": "112233",
"notes": {
"random_key_1": "Make it so.",
"random_key_2": "Tea. Earl Grey. Hot."
},
"fund_account": {
"id": "fa_00000000000001",
"entity": "fund_account",
"account_type":"vpa",
"vpa":{
"address":"gaurav.kumar@exampleupi"
},
"active": true,
"created_at": 1567064019,
"contact": {
"id": "cont_00000000000001",
"entity": "contact",
"name":"Gaurav Kumar",
"email":"gaurav.kumar@example.com",
"contact":"9123456789",
"type":"employee",
"reference_id":"Acme Contact ID 12345",
"active": true,
"created_at": 1567064019,
"notes":{
"notes_key_1":"Tea, Earl Grey, Hot",
"notes_key_2":"Tea, Earl Grey... decaf."
}
}
}
}
{
"id": "fav_00000000000001",
"entity": "fund_account.validation",
"status": "completed",
"utr": "123456789012",
"validation_results": {
"account_status": "active",
"registered_name": "Gaurav Kumar",
"details": "The beneficiary account is valid.",
"name_match_score": 100,
"validated_account_type" : "bank account",
"bank_account": {
"bank_routing_code": "ICIC0000047",
"account_number": "1121431121541121",
"bank_name": "ICICI Bank",
"account_type": "saving"
}
},
"status_details": {
"description": "Validation request is completed",
"source": "beneficiary_bank",
"reason": "validation_completed"
},
"reference_id": "112233",
"notes": {
"random_key_1": "Make it so.",
"random_key_2": "Tea. Earl Grey. Hot."
},
"fund_account": {
"id": "fa_00000000000001",
"entity": "fund_account",
"account_type": "vpa",
"vpa": {
"address": "gaurav.kumar@exampleupi"
},
"active": true,
"created_at": 1567064019,
"contact": {
"id": "cont_00000000000001",
"entity": "contact",
"name": "Gaurav Kumar",
"email": "gaurav.kumar@example.com",
"contact": "9123456789",
"type": "employee",
"reference_id": "Acme Contact ID 12345",
"active": true,
"created_at": 1567064019,
"notes": {
"notes_key_1": "Tea, Earl Grey, Hot",
"notes_key_2": "Tea, Earl Grey... decaf."
}
}
}
}
{
"id": "fav_00000000000002",
"entity": "fund_account.validation",
"fund_account": {
"id": "fa_00000000000002",
"entity": "fund_account",
"contact_id": "cont_00000000000001",
"account_type": "vpa",
"vpa": {
"username": "gaurav.kumar",
"handle": "exampleupi",
"address": "gaurav.kumar@exampleupi"
},
"batch_id": null,
"active": true,
"created_at": 1573110860
},
"status": "failed",
"amount": null,
"currency": null,
"notes": {
"random_key_1": "Make it so.",
"random_key_2": "Tea. Earl Grey. Hot."
},
"validation_results": {
"account_status": "",
"registered_name": "",
"details": null,
"name_match_score": null,
"bank_account": {
"bank_name": null,
"ifsc": null,
"account_number": null,
"account_type": null
}
},
"created_at": 1574244676,
"utr": null
}
Available in🇮🇳 India🇲🇾 Malaysia🇺🇸 United States
Use this endpoint to create contact, fund account and validate VPA (UPI) in a single API call.
curl -u <YOUR_KEY>:<YOUR_SECRET> \
-X POST https://api.razorpay.com/v1/fund_accounts/validations \
-H "Content-Type: application/json" \
-d '{
"source_account_number": "7878780080316316",
"reference_id": "112233",
"notes": {
"random_key_1": "Make it so.",
"random_key_2": "Tea. Earl Grey. Hot."
},
"fund_account": {
"account_type":"vpa",
"vpa":{
"address":"gaurav.kumar@exampleupi"
}
"contact": {
"name":"Gaurav Kumar",
"email":"gaurav.kumar@example.com",
"contact":"9123456789",
"type":"employee",
"reference_id":"Acme Contact ID 12345",
"notes":{
"notes_key_1":"Tea, Earl Grey, Hot",
"notes_key_2":"Tea, Earl Grey... decaf."
}
}
}
}
}'
{
"id": "fav_00000000000001",
"entity": "fund_account.validation",
"status": "created",
"utr" : "123456789012",
"validation_results": {
"account_status": null,
"registered_name": null,
"details": null,
"name_match_score": null
},
"status_details": {
"description": "Validation request is created",
"source": "internal",
"reason": "validation_request_created"
},
"reference_id": "112233",
"notes": {
"random_key_1": "Make it so.",
"random_key_2": "Tea. Earl Grey. Hot."
},
"fund_account": {
"id": "fa_00000000000001",
"entity": "fund_account",
"account_type":"vpa",
"vpa":{
"address":"gaurav.kumar@exampleupi"
},
"active": true,
"created_at": 1567064019,
"contact": {
"id": "cont_00000000000001",
"entity": "contact",
"name":"Gaurav Kumar",
"email":"gaurav.kumar@example.com",
"contact":"9123456789",
"type":"employee",
"reference_id":"Acme Contact ID 12345",
"active": true,
"created_at": 1567064019,
"notes":{
"notes_key_1":"Tea, Earl Grey, Hot",
"notes_key_2":"Tea, Earl Grey... decaf."
}
}
}
}
{
"id": "fav_00000000000001",
"entity": "fund_account.validation",
"status": "completed",
"utr": "123456789012",
"validation_results": {
"account_status": "active",
"registered_name": "Gaurav Kumar",
"details": "The beneficiary account is valid.",
"name_match_score": 100,
"validated_account_type" : "bank account",
"bank_account": {
"bank_routing_code": "ICIC0000047",
"account_number": "1121431121541121",
"bank_name": "ICICI Bank",
"account_type": "saving"
}
},
"status_details": {
"description": "Validation request is completed",
"source": "beneficiary_bank",
"reason": "validation_completed"
},
"reference_id": "112233",
"notes": {
"random_key_1": "Make it so.",
"random_key_2": "Tea. Earl Grey. Hot."
},
"fund_account": {
"id": "fa_00000000000001",
"entity": "fund_account",
"account_type": "vpa",
"vpa": {
"address": "gaurav.kumar@exampleupi"
},
"active": true,
"created_at": 1567064019,
"contact": {
"id": "cont_00000000000001",
"entity": "contact",
"name": "Gaurav Kumar",
"email": "gaurav.kumar@example.com",
"contact": "9123456789",
"type": "employee",
"reference_id": "Acme Contact ID 12345",
"active": true,
"created_at": 1567064019,
"notes": {
"notes_key_1": "Tea, Earl Grey, Hot",
"notes_key_2": "Tea, Earl Grey... decaf."
}
}
}
}
{
"id": "fav_00000000000002",
"entity": "fund_account.validation",
"fund_account": {
"id": "fa_00000000000002",
"entity": "fund_account",
"contact_id": "cont_00000000000001",
"account_type": "vpa",
"vpa": {
"username": "gaurav.kumar",
"handle": "exampleupi",
"address": "gaurav.kumar@exampleupi"
},
"batch_id": null,
"active": true,
"created_at": 1573110860
},
"status": "failed",
"amount": null,
"currency": null,
"notes": {
"random_key_1": "Make it so.",
"random_key_2": "Tea. Earl Grey. Hot."
},
"validation_results": {
"account_status": "",
"registered_name": "",
"details": null,
"name_match_score": null,
"bank_account": {
"bank_name": null,
"ifsc": null,
"account_number": null,
"account_type": null
}
},
"created_at": 1574244676,
"utr": null
}
Request Parameters
The account from which money should be deducted for the account validation transaction.
Key-value pair that can be used to store additional information about the entity. Maximum 15 key-value pairs, 256 characters (maximum) each. For example,
"note_key": "Beam me up Scotty”.A user-generated reference given to the payout. Maximum length is 40 characters. For example,
112233. You can use this field to store your own transaction ID, if any.Response Parameters
A 12-digit unique identifier for the successful IMPS fund account validation transaction. For example,
123456789012.A score between 0 - 100.
100: The name provided by you and the bank registered name are the same.0: There is no match between the name provided by you and the bank registered name.- Between
0&100: There is a partial match between the name provided by you and the bank registered name.
Possible values:
gateway: Technical error at Razorpay Curlec Partner bank.beneficiary_bank: Technical error at beneficiary bank.business: Merchant action required.internal: Technical error at Razorpay Curlec’s server.
A user-generated reference given to the payout. Maximum length is 40 characters. For example,
112233. You can use this field to store your own transaction ID, if any.Last modified on November 17, 2026
Was this page helpful?