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",
"validation_type": "upi_intent",
"reference_id": "112233",
"notes": {
"random_key_1": "Make it so",
"random_key_2": "Tea. Earl Grey. Hot."
}
}'
{
"id": "fav_00000000000001",
"entity": "fund_account.validation",
"status": "created",
"utr": "123456789012",
"upi_intent": {
"intent_url": "upi://pay?pa=razorpayx@citibank&pn=RZPX%20PRIVATE%20LTD&mc=7413&cu=INR&am=1.00&tn=BAV&ver=01&mode=04&qrMedium=02&tr=RjY7anDJFuKQOB",
"phonepe_url": "phonepe://upi/pay?pa=razorpayx@citibank&pn=RZPX%20PRIVATE%20LTD&mc=7413&cu=INR&am=1.00&tn=BAV&ver=01&mode=04&qrMedium=02&tr=RjY7anDJFuKQOB",
"gpay_url": "tez://upi/pay?pa=razorpayx@citibank&pn=RZPX%20PRIVATE%20LTD&mc=7413&cu=INR&am=1.00&tn=BAV&ver=01&mode=04&qrMedium=02&tr=RjY7anDJFuKQOB",
"paytm_url": "paytmmp://upi/pay?pa=razorpayx@citibank&pn=RZPX%20PRIVATE%20LTD&mc=7413&cu=INR&am=1.00&tn=BAV&ver=01&mode=04&qrMedium=02&tr=RjY7anDJFuKQOB",
"bhim_url": "bhim://upi/pay?pa=razorpayx@citibank&pn=RZPX%20PRIVATE%20LTD&mc=7413&cu=INR&am=1.00&tn=BAV&ver=01&mode=04&qrMedium=02&tr=RjY7anDJFuKQOB",
"encoded_qr_code": "iVBORw0KGgoAAAANSUhEUgAAAQAAAAEAAQMAAABmvDolAAAABlBMVEX///8AAABVwtN+AAACWUlEQVR42uyYy3E7LRDEe4sDR0IglM1sH+"
},
"validation_results": {
"account_status": null,
"registered_name": null,
"details": null,
"name_match_score": null,
"validated_account_type": null,
"bank_account": {
"bank_routing_code": null,
"account_number": null,
"bank_name": null,
"account_type": 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."
}
}
{
"id": "fav_00000000000001",
"entity": "fund_account.validation",
"status": "completed",
"utr": "123456789012",
"validation_results": {
"account_status": "active",
"registered_name": "GAURAV KUMAR",
"validated_account_type": "Bank_Account",
"name_match_score": "00",
"bank_account": {
"bank_routing_code": "HDFC0000053",
"account_number": "765432123456789",
"bank_name": "HDFC Bank",
"account_type": "SAVINGS"
},
"upi_intent": {
"vpa": "example@upi"
}
}
}
Account Validation
Validate Bank Account (VPA) via Reverse Penny Drop
Validate your contact’s bank account instantly via Reverse Penny Drop.
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",
"validation_type": "upi_intent",
"reference_id": "112233",
"notes": {
"random_key_1": "Make it so",
"random_key_2": "Tea. Earl Grey. Hot."
}
}'
{
"id": "fav_00000000000001",
"entity": "fund_account.validation",
"status": "created",
"utr": "123456789012",
"upi_intent": {
"intent_url": "upi://pay?pa=razorpayx@citibank&pn=RZPX%20PRIVATE%20LTD&mc=7413&cu=INR&am=1.00&tn=BAV&ver=01&mode=04&qrMedium=02&tr=RjY7anDJFuKQOB",
"phonepe_url": "phonepe://upi/pay?pa=razorpayx@citibank&pn=RZPX%20PRIVATE%20LTD&mc=7413&cu=INR&am=1.00&tn=BAV&ver=01&mode=04&qrMedium=02&tr=RjY7anDJFuKQOB",
"gpay_url": "tez://upi/pay?pa=razorpayx@citibank&pn=RZPX%20PRIVATE%20LTD&mc=7413&cu=INR&am=1.00&tn=BAV&ver=01&mode=04&qrMedium=02&tr=RjY7anDJFuKQOB",
"paytm_url": "paytmmp://upi/pay?pa=razorpayx@citibank&pn=RZPX%20PRIVATE%20LTD&mc=7413&cu=INR&am=1.00&tn=BAV&ver=01&mode=04&qrMedium=02&tr=RjY7anDJFuKQOB",
"bhim_url": "bhim://upi/pay?pa=razorpayx@citibank&pn=RZPX%20PRIVATE%20LTD&mc=7413&cu=INR&am=1.00&tn=BAV&ver=01&mode=04&qrMedium=02&tr=RjY7anDJFuKQOB",
"encoded_qr_code": "iVBORw0KGgoAAAANSUhEUgAAAQAAAAEAAQMAAABmvDolAAAABlBMVEX///8AAABVwtN+AAACWUlEQVR42uyYy3E7LRDEe4sDR0IglM1sH+"
},
"validation_results": {
"account_status": null,
"registered_name": null,
"details": null,
"name_match_score": null,
"validated_account_type": null,
"bank_account": {
"bank_routing_code": null,
"account_number": null,
"bank_name": null,
"account_type": 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."
}
}
{
"id": "fav_00000000000001",
"entity": "fund_account.validation",
"status": "completed",
"utr": "123456789012",
"validation_results": {
"account_status": "active",
"registered_name": "GAURAV KUMAR",
"validated_account_type": "Bank_Account",
"name_match_score": "00",
"bank_account": {
"bank_routing_code": "HDFC0000053",
"account_number": "765432123456789",
"bank_name": "HDFC Bank",
"account_type": "SAVINGS"
},
"upi_intent": {
"vpa": "example@upi"
}
}
}
Available in🇮🇳 India🇲🇾 Malaysia🇸🇬 Singapore🇺🇸 United States
Use this endpoint to validate the bank account details via Reverse Penny Drop.
Watch Out!This API is not supported in test mode. Ensure you switch to live mode before proceeding.
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",
"validation_type": "upi_intent",
"reference_id": "112233",
"notes": {
"random_key_1": "Make it so",
"random_key_2": "Tea. Earl Grey. Hot."
}
}'
{
"id": "fav_00000000000001",
"entity": "fund_account.validation",
"status": "created",
"utr": "123456789012",
"upi_intent": {
"intent_url": "upi://pay?pa=razorpayx@citibank&pn=RZPX%20PRIVATE%20LTD&mc=7413&cu=INR&am=1.00&tn=BAV&ver=01&mode=04&qrMedium=02&tr=RjY7anDJFuKQOB",
"phonepe_url": "phonepe://upi/pay?pa=razorpayx@citibank&pn=RZPX%20PRIVATE%20LTD&mc=7413&cu=INR&am=1.00&tn=BAV&ver=01&mode=04&qrMedium=02&tr=RjY7anDJFuKQOB",
"gpay_url": "tez://upi/pay?pa=razorpayx@citibank&pn=RZPX%20PRIVATE%20LTD&mc=7413&cu=INR&am=1.00&tn=BAV&ver=01&mode=04&qrMedium=02&tr=RjY7anDJFuKQOB",
"paytm_url": "paytmmp://upi/pay?pa=razorpayx@citibank&pn=RZPX%20PRIVATE%20LTD&mc=7413&cu=INR&am=1.00&tn=BAV&ver=01&mode=04&qrMedium=02&tr=RjY7anDJFuKQOB",
"bhim_url": "bhim://upi/pay?pa=razorpayx@citibank&pn=RZPX%20PRIVATE%20LTD&mc=7413&cu=INR&am=1.00&tn=BAV&ver=01&mode=04&qrMedium=02&tr=RjY7anDJFuKQOB",
"encoded_qr_code": "iVBORw0KGgoAAAANSUhEUgAAAQAAAAEAAQMAAABmvDolAAAABlBMVEX///8AAABVwtN+AAACWUlEQVR42uyYy3E7LRDEe4sDR0IglM1sH+"
},
"validation_results": {
"account_status": null,
"registered_name": null,
"details": null,
"name_match_score": null,
"validated_account_type": null,
"bank_account": {
"bank_routing_code": null,
"account_number": null,
"bank_name": null,
"account_type": 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."
}
}
{
"id": "fav_00000000000001",
"entity": "fund_account.validation",
"status": "completed",
"utr": "123456789012",
"validation_results": {
"account_status": "active",
"registered_name": "GAURAV KUMAR",
"validated_account_type": "Bank_Account",
"name_match_score": "00",
"bank_account": {
"bank_routing_code": "HDFC0000053",
"account_number": "765432123456789",
"bank_name": "HDFC Bank",
"account_type": "SAVINGS"
},
"upi_intent": {
"vpa": "example@upi"
}
}
}
Request Parameters
Key-value pair that can be used to store additional information about the entity. Maximum 15 key-value pairs, 256 characters (maximum) each.
Response Parameters
The status of the fund account validation. For example, in the initial response, it could be
created and in the after payment response, completed.The Unique Transaction Reference number assigned to the ₹1 UPI payment made by the end user. Use this to track or reconcile the transaction.
Contains deep links to launch specific UPI apps directly on the user’s device, allowing them to complete the ₹1 payment without manually entering details.
A generic UPI deep link that opens the user’s default or available UPI app to initiate the payment.
A Base64-encoded QR code image. Display this on your interface so users can scan it using any UPI app to complete the ₹1 payment.
Contains the verified account details extracted from the payer’s bank after the ₹1 payment is received.
A numeric score indicating how closely the account holder’s registered name matches the name provided during the request.
The IFSC code of the payer’s bank branch, used to identify and route transactions to the correct bank.
Last modified on October 8, 2026
Was this page helpful?