EzKRA (KRA Microservice)
Push Onboarding to KRA
7 min
introduction once the application is created the data has to be pushed on signzy's platform for further validation and operations to be performed the push onboarding json consists below objects with input variables kyc data contains personal and financial information such as gender, marital status, nominee relationship, pan number, aadhaar number, residential status, occupation details, annual income, and contact details identity proof contains details about the identity proof provided by the customer, such as type of proof, name, father's name, pan number, date of birth, and file url address proof contains details about the address proof provided by the customer, such as type of proof, name, expiry date, issue date, date of birth, address, pincode, state, district, city, and file url correspondence address proof contains details about the correspondence address proof provided by the customer, such as type of proof, name, number, address, pincode, date of birth, state, district, city, expiry date, file url, country, and whether the address is the same as a permanent address bank account contains file url for the bank account details video contains file url for the video submitted by the customer fatca data contains information related to the customer's compliance with fatca regulations, such as pep status, rpep status, residence for tax in india, and related person status it also includes details about the customer's place of birth, country of birth, and tax identification number api endpoint push onboarding preproduction https //backops investor onboarding preproduction signzy tech/kra handler/api/onboardings/push production https //backops investor onboarding signzy tech/kra handler/api/onboardings/push sample request curl location 'https //backops investor onboarding preproduction signzy tech/kra handler/api/onboardings/push' \\ \ header 'content type application/json' \\ \ header 'accept application/json' \\ \ header 'authorization \<authorization token>' \\ \ data '{ "onboardingdata" { "kycdata" { "gender" "", "emailid" "", "countrycode" "", "pannumber" "", "maidenname" "", "fathername" "", "fathertitle" "", "maidentitle" "", "mothertitle" "", "mothername" "", "mobilenumber" "", "annualincome" "", "aadhaarnumber" "", "maritalstatus" "", "kycaccountcode" "", "occupationcode" "", "occupationother" "", "residentialstatus" "", "citizenshipcountry" "", "nomineerelationship" "", "permanentaddresstype" "", "permanentaddresscode" "", "occupationdescription" "", "kycaccountdescription" "", "applicationstatuscode" "", "citizenshipcountrycode" "", "communicationaddresscode" "", "communicationaddresstype" "", "applicationstatusdescription" "", "annualincomerange" "", "placeofbirth" "" }, "identityproof" { "name" "", "fathername" "", "dateofbirth" "", "type" "", "number" "", "fileurl" \[] }, "addressproof" { "expirydate" "", "issuedate" "", "address" "", "pincode" "", "city" "", "state" "", "district" "", "country" "", "name" "", "dateofbirth" "", "type" "", "number" "", "fileurl" \[] }, "corraddressproof" { "expirydate" "", "issuedate" "", "address" "", "pincode" "", "city" "", "state" "", "district" "", "country" "", "name" "", "dateofbirth" "", "type" "", "number" "", "fileurl" \[], "sameaspermanent" "" }, "bankaccount" { "fileurl" \[] }, "video" { "fileurl" \[] }, "fatcadata" { "pep" "no", "rpep" "no", "residentfortaxotherthanindia" "yes", "placeofbirth" "", "networth" "", "countrycodeofbirth" "in", "relatedperson" "no", "fatcadeclarationdate" "28/06/2024", "fatcaadditionaldetails" \[ { "countrycodejurisdictionresidence" "india", "taxexempt" "yes", "tinexemptreason" "01", "taxidentificationnumber" "123123" } ], "relatedpersondata" { "type" "assignee", "title" "mrs ", "name" " ", "kycnumber" "", "relatedpersonidentityproof" { "type" "", "number" "", "expirydate" "11/01/2052", "fileurl" \[ "" ] } }, "address" { "pincode" "", "city" "", "district" "", "state" "", "country" "", "address" "" } }, "signature" { "signatureimageurl" "" }, "userforensics" { "userdata" { "geodata" { "city" "" } } }, "userphoto" "", "esign" { "signedpdf" "" }, "empdetails" { "name" "", "designation" "", "branch" "", "code" "" } }, "callbackurl" "" }' request field description 120,176,113,95 false true false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type false unhandled content type sample responses 200 { "customerid" "63xxxxxxx61", "requestid" "64xxxxxxxxx05f", "callbackurl" "https //eoji86rqlkxh0zx m pipedream net" } 400 sample 1 when poi is pan { "error" { "statuscode" 400, "name" "validationerror", "message" "\\"onboardingdata identityproof number\\" is not allowed to be empty", "details" \[ { "message" "\\"onboardingdata identityproof number\\" is not allowed to be empty", "path" \[ "onboardingdata", "identityproof", "number" ], "type" "string empty", "context" { "label" "onboardingdata identityproof number", "value" "", "key" "number" } } ] } } sample 2 when poi is aadhaar and aadhaar number is invalid { "error" { "statuscode" 400, "name" "validationerror", "message" "\\"onboardingdata identityproof number\\" with value \\"0000\\" fails to match the 8 zeros followed by 4 digits pattern", "details" \[ { "message" "\\"onboardingdata identityproof number\\" with value \\"0000\\" fails to match the 8 zeros followed by 4 digits pattern", "path" \[ "onboardingdata", "identityproof", "number" ], "type" "string pattern name", "context" { "name" "8 zeros followed by 4 digits", "regex" {}, "value" "0000", "label" "onboardingdata identityproof number", "key" "number" } } ] } } sample 3 when mobile is passed as "999" { "error" { "statuscode" 400, "name" "validationerror", "message" "please enter a valid 10 digit mobile number ", "details" \[ { "message" "please enter a valid 10 digit mobile number ", "path" \[ "onboardingdata", "kycdata", "mobilenumber" ], "type" "string pattern name", "context" { "name" "mobile number", "regex" {}, "value" "999", "label" "onboardingdata kycdata mobilenumber", "key" "mobilenumber" } } ] } } 401 { "error" { "statuscode" 401, "name" "error", "message" "authorization required", "code" "authorization required" } } 404 while using invalid endpoint { "error" { "statuscode" 404, "name" "error", "message" "there is no method to handle get /6451198320bf270e75ce7618/onboardings/6464ad5eb4f191002445b509" } } 405 using incorrect request method type 405 not allowed 	 	 405 not allowed 	 502 502 bad gateway 502 bad gateway response field description 139,145,488 true left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type getting help please feel free to contact us if you have any questions, require clarification, or have ideas for how to make the documents or any of our services better you can reach out to us at help\@signzy com