Validate a VPA

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": "pennydrop",
    "reference_id": "112233",
    "notes": {
      "key_1": "value_1",
      "key_2": "value_2"
    },
    "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": "Contact_12345"
      }
    }
  }'

{
  "id": "fav_00000000000001",
  "entity": "fund_account.validation",
  "status": "completed",
  "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": "XXXXXXXX5599",
      "bank_name": "ICICI Bank",
      "account_type": "savings"
    }
  },
  "status_details": {
    "description": "Validation request is completed",
    "source": "beneficiary_bank",
    "reason": "validation_completed"
  },
  "reference_id": "112233",
  "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": "Contact_12345",
      "active": true
    }
  }
}

{
  "id": "fav_00000000000002",
  "entity": "fund_account.validation",
  "status": "failed",
  "validation_results": {
    "account_status": "",
    "registered_name": "",
    "details": "The beneficiary account is valid",
    "name_match_score": 100,
    "validated_account_type":
    "bank_account": {
      "bank_routing_code": null,
      "account_number": null,
      "bank_name": null,
      "account_type": null
    }
  },
  "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
  },
  "amount": null,
  "currency": null,
  "notes": {
    "random_key_1": "Make it so.",
    "random_key_2": "Tea. Earl Grey. Hot."
  },
  },
  "created_at": 1574244676,
  "utr": null
}

POST

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": "pennydrop",
    "reference_id": "112233",
    "notes": {
      "key_1": "value_1",
      "key_2": "value_2"
    },
    "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": "Contact_12345"
      }
    }
  }'

{
  "id": "fav_00000000000001",
  "entity": "fund_account.validation",
  "status": "completed",
  "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": "XXXXXXXX5599",
      "bank_name": "ICICI Bank",
      "account_type": "savings"
    }
  },
  "status_details": {
    "description": "Validation request is completed",
    "source": "beneficiary_bank",
    "reason": "validation_completed"
  },
  "reference_id": "112233",
  "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": "Contact_12345",
      "active": true
    }
  }
}

{
  "id": "fav_00000000000002",
  "entity": "fund_account.validation",
  "status": "failed",
  "validation_results": {
    "account_status": "",
    "registered_name": "",
    "details": "The beneficiary account is valid",
    "name_match_score": 100,
    "validated_account_type":
    "bank_account": {
      "bank_routing_code": null,
      "account_number": null,
      "bank_name": null,
      "account_type": null
    }
  },
  "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
  },
  "amount": null,
  "currency": null,
  "notes": {
    "random_key_1": "Make it so.",
    "random_key_2": "Tea. Earl Grey. Hot."
  },
  },
  "created_at": 1574244676,
  "utr": null
}

Use this endpoint to create a VPA (UPI) account validation transaction.

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": "pennydrop",
    "reference_id": "112233",
    "notes": {
      "key_1": "value_1",
      "key_2": "value_2"
    },
    "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": "Contact_12345"
      }
    }
  }'

{
  "id": "fav_00000000000001",
  "entity": "fund_account.validation",
  "status": "completed",
  "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": "XXXXXXXX5599",
      "bank_name": "ICICI Bank",
      "account_type": "savings"
    }
  },
  "status_details": {
    "description": "Validation request is completed",
    "source": "beneficiary_bank",
    "reason": "validation_completed"
  },
  "reference_id": "112233",
  "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": "Contact_12345",
      "active": true
    }
  }
}

{
  "id": "fav_00000000000002",
  "entity": "fund_account.validation",
  "status": "failed",
  "validation_results": {
    "account_status": "",
    "registered_name": "",
    "details": "The beneficiary account is valid",
    "name_match_score": 100,
    "validated_account_type":
    "bank_account": {
      "bank_routing_code": null,
      "account_number": null,
      "bank_name": null,
      "account_type": null
    }
  },
  "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
  },
  "amount": null,
  "currency": null,
  "notes": {
    "random_key_1": "Make it so.",
    "random_key_2": "Tea. Earl Grey. Hot."
  },
  },
  "created_at": 1574244676,
  "utr": null
}

Request Parameters

string

required

The account from which money should be deducted for the account validation transaction.

Pass your customer identifier if you want money to be deducted from RazorpayX Lite.

Watch Out!

This is not your contact’s bank account number. Log in to your RazorpayX Dashboard and go to My Account & Settings → Banking → Customer Identifier.
This value is different for Test Mode and Live Mode.
RazorpayX Lite is currently not available for new merchants. To set up a new RazorpayX account, refer to Current Account.

string

required

The method used for validating the bank account. In this case, pennydrop.

string

Maximum 40 characters. A user-entered reference for the contact. For example, Acme Contact ID 12345.

object

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”.

object

required

The fund account id you want to validate.

string

Customer’s bank account type. Possible values:

savings (default)
current

string

required

Target recipient’s VPA address.

object

required

The details of the contact.

string

The customer’s name. For example, Gaurav Kumar.

string

The customer’s email address. For example, gaurav.kumar@example.com.

string

The customer’s phone number. A maximum length of 15 characters, including country code. For example, +919000090000.

string

Defines the contact type . For example, employee

Response Parameters

string

The unique identifier linked to the fund account validation. For example, fav_0000000001.

string

Here it is fund_account.validation.

string

The status of the account validation transaction. Possible values:

created
completed
failed

object

Details extracted from the results of the fund account validation.

string

Displays if the account is valid or not. Possible values:

active
invalid

string

The name linked to the account. For example,Gaurav Kumar or null.

string

Brief description of the validation.

string

The percentage score indicating how closely the account holder’s name matches the records.

string

Here it is bank_account.

object

The contact’s bank account details.

string

Beneficiary bank IFSC. For example, HDFC0000053.

string

Beneficiary account number. For example, 765432123456789.

string

The contact’s bank name. For example, HDFC.

string

The account type being validated. For example savings, current.

object

Status of the fund account validation.

string

A brief description stating if the validation is complete or not.

string

The source from which validation was done. For example, beneficiary_bank

string

Reason for validation.

string

Unique reference_id generated for the validation transaction.

object

The details of the fund account which was validated.

string

The unique identifier linked to the fund account. For example, fa_00000000000001.

string

Here it is fund_account.

string

Fund account type.

object

The details associated with the account holder’s virtual payment address.

string

The virtual payment address of the contact whose account is validated. For example, gaurav.kumar@exampleupi

boolean

Possible values of fund account status:

true: active
false: inactive

integer

Timestamp, in unix, when the fund account was created. For example, 1543650891.

object

The contact’s details.

string

The unique identifier linked to the contact. For example, cont_00000000000001.

string

Here it is contact

string

Account holder’s name. For example,Gaurav Kumar.

string

Email address of the contact.

string

Phone number of the contact.

string

Contact Type. For example, employee, contractor.

string

Reference id associated with the contact.

boolean

Possible values of contact status:

true: active
false: inactive

Partners

Payout APIs

Request Parameters

Response Parameters

​Request Parameters

​Response Parameters

Request Parameters

Response Parameters