3. Fetch Account Details

3.1 POST URL: /vpa/fetchaccountdetail

Request Parameters

#	Parameter Name	Data Type	Constraint	Description	Presence
1	originatorUniqueId	String	Length(max. 30)	Originator unique identifier	M
2	bankId	String	Length(max. 4)	Beneficiary participant code in NCHL system	M
3	vpa	String	Length(10)	Beneficiary identifier (VPA) for fund transfer	M
4	requestToken	String		Token	M

Note: For connectIPS based VPA transaction, bank id will be CIPS.

Token String= originatorUniqueId+”,”+ vpa+”,” + bankId+”,”+ userId

Response Parameters

#	Parameter Name	Data Type	Constraint	Description	Presence
1	requestIdentifier	String	Length(20)	Request id provided by NPI	M
2	originatorUniqueId	String	Length(max. 30)	Originator unique identifier	M
3	vpa	String	Length(10)	Beneficiary identifier (VPA) for fund transfer	M
4	bankId	String	Length(max. 4)	Beneficiary participant code in NCHL system	M
5	acctName	String		Beneficiary account name	M
6	accountId	String	Length(max. 20)	Beneficiary account number	M
7	token	String		Token	M

Token String= requestIdentifier +”,” +originatorUniqueId+”,” + bankId+”,” + vpa+”,” +acctName +”,” + accountId + “,” + userId

Sample Request

{
 "originatorUniqueId": "VPA-123456",
 "bankId": "2301",
 "vpa":"9841000000",
 "requestToken": “TOKEN”
}

Success Response

{
 "requestIdentifier": "2021081**812628Srm",
 "originatorUniqueId": " VPA-123456",
 "vpa": "9841000000",
 "bankId": "2301",
 "acctName": "BISH*****NTHI",
 "accountId": "************3456",
 "token" : “TOKEN”
}

Failure Response

Case I
{
 "responseCode": "E007",
 "responseDescription": "TECHNICAL VALIDATION FAILED",
 "fieldErrors": [
 {
 "field": "originatorUniqueId",
 "message": "Duplicate request."
 }
 ]
}

Case II
{
 "responseCode": "400",
 "responseDescription": "PARAMETER VALIDATION ERROR",
 "fieldErrors": [
 {
 "field": "vpa",
 "message": "VPA should not less than 10-character."
 }
 ]
}