Skip to main content

Create FD

Create FD

Postman Collection

URL

POST : /v1/service/investment/onboard/merchant

Headers

Content-Type  (String)   required
application/json
Authorization  (String)   required
Basic Auth
Accept  (String)   required
application/json

Body Params

title  (String)   Required
Merchant title Name
firstName  (String)   Required
Merchant First Name
middleName  (String)   Required
Merchant Middle Name
lastName  (String)   Required
Merchant Last Name
dob  (String)   Required
Merchant Date of Birth
gender  (String)   Required
Merchant Gender
panNo  (String)   Required
Merchant Pan Card Number
aadhaar  (String)   Required
Merchant aadhhar
address  (String)   Required
Merchant Address 1
address2  (String)   Required
Merchant Address 2
area  (String)   Required
Merchant Area
city  (String)   Required
Merchant City
state  (String)   Required
Merchant State
country  (String)   Required
Merchant Country
pinCode  (String)   Required
Merchant Pin Code
mobileNo  (String)   Required
Merchant Mobile Number
email  (String)   Required
Merchant Email Id
amount  (String / Fixed)   Required
Investment Amount (must be greater than ₹5000)
schemePeriod  (String)   Required
FD scheme Period
rateOfInterest  (String / Fixed)   Required
FD rate of Interest (Rate of Interest will be defined w.r.t Calculator)
interestFrequency  (String / Fixed)   Required
FD Interest Frequency (AtMaturity, Monthly, Quarterly, Half-Yearly, Yearly)
accountType  (String / Fixed)   Required
Merchant Account Type (Saving A/c, Current A/c)
ifsc  (String)   Required
Merchant Bank Account IFSC Code
accountNumber  (String)   Required
Merchant Bank Account Number
bankName  (String)   Required
Merchant Bank Name
branchName  (String)   Required
Merchant Bank Branch Name
nomineeTitle  (String)   Optional
Merchant Nominee Title
nomineeFirstName  (String)   Optional
Merchant Nominee First Name
nomineeMiddleName  (String)   Optional
Merchant Nominee Middle Name
nomineeLastName  (String)   Optional
Merchant Nominee Last Name
nomineeRelation  (String)   Optional
Merchant Nominee Relation
nomineeDOB  (String)   Optional
Merchants Nominee DOB
nomineeGuardianTitle  (String)   Optional
Merchant Gaurdian Title
nomineeGuardianFirstName  (String)   Optional
Merchant Nominee Guardian First Name
nomineeGuardianMiddleName  (String)   Optional
Merchant Nominee Guardian Middle Name
nomineeGuardianLastName  (String)   Optional
Merchant Nominee Guardian Last Name

Request

Example Request
    curl --location --request POST '/v1/service/investment/onboard/merchant' \
--header 'Content-Type: application/json' \
--header 'Authorization: Basic e3tsb2NfdXNlcn19Ont7bG9jX3Bhc3N9fQ==' \
--data-raw '{
"title": "Mr.",
"firstName": "ABC",
"middleName": "",
"lastName": "XYZ",
"dob": "19-05-1987",
"gender": "Male",
"panNo": "AAAAA1111J",
"aadhaar": "12345678912",
"address": "address one",
"address2": "address two",
"area": "test",
"city": "test",
"state": "test",
"country": "test",
"pincode": "111111",
"mobileNo": "9999999999",
"email": "testxettl3e@test.com",
"amount": "50000",
"schemePeriod": "12",
"rateOfInterest": "7.5",
"interestFrequency": "Quarterly",
"accountType": "Saving A/c",
"ifsc": "ALLA0AU1015",
"accountNumber": "131131113",
"bankName": "ALLAHABAD UP GRAMIN BANK",
"branchName": "REWARI",
"nomineeTitle": "Mrs",
"nomineeFirstName": "SUNDARA",
"nomineeMiddleName": "KRISHNA",
"nomineeLastName": "I",
"nomineeRelation": "MOTHER",
"nomineeDOB": "01/01/1945",
"nomineeGuardianTitle": "",
"nomineeGuardianFirstName": "",
"nomineeGuardianMiddleName": "",
"nomineeGuardianLastName": ""
}'

Response Samples

{
"code": "0x0200",
"message": "Merchant Onboarded Sucessfully",
"status": "SUCCESS",
"data": {
"certificateNo": "S2305100002",
"orderRefId": "INT5965981449804679F17"
}
}

Response Code

Status CodeStatusMessage
0x0200SUCCESSTRANSACTION SUCCESSFULL
0x0201UNAUTHORIZEDUNAUTHORIZED USER
0x0202FAILUREFAILURE USER
0x0203MISSING_PARAMETERMISSING PARAMETER
0x0204CONNECTION_TIMEOUTCONNECTION TIMEOUT
0x0205SOMETHING_WENT_WRONGSOMETHING WENT WRONG
0x0206PENDINGTRANSACTION PENDING
0x02082FATWO FACTOR AUNTHENTICATION