Update Fatca Form
/api/merchants/updateForm
Property | Value |
Content-type | application/json |
Authorization | ...access token... (alphanumeric string of length 64) |
Property | Data Type | Example Values |
merchantId | String (Required), alphanumeric string of length 24 | userId from the investor login response field |
save | Enum String (Required) | "formData" |
type | Enum String (Required) | "fatca" |
data | Object (Required) | payload |
--type | Enum String (Required) | "fatca" |
--fatcaData | Object (Required) | fatca data |
----pep | Enum String (Required) | whether a 'politically exposed person' values: "YES" / "NO" |
----rpep | Enum String (Required) | whether a 'related to a politically exposed person' values: "YES" / "NO" |
----residentForTaxInIndia | Enum String (Required) | whether a 'resident outside of India' values: "YES" / "NO" |
----countryCodeJurisdictionResidence | Enum String (Optional) | Country of Jurisdiction of Residence code (Refer Table 1.1), to be provided given "residentForTaxInIndia" is "YES" |
----countryJurisdictionResidence | String(Optional) | Country of Jurisdiction of Residence (Refer Table 1.1), to be provided given "residentForTaxInIndia" is "YES" |
----taxIdentificationNumber | String(Optional) | Tax Identification Number, to be provided given "residentForTaxInIndia" is "YES" |
----placeOfBirth | String(Optional) | Place of Birth, to be provided given "residentForTaxInIndia" is "YES" |
----countryCodeOfBirth | Enum String(Optional) | Country code of birth (Refer Table 1.1), to be provided given "residentForTaxInIndia" is "YES" |
----countryOfBirth | String(Optional) | Country of birth (Refer Table 1.1), to be provided given "residentForTaxInIndia" is "YES" |
----addressType | String(Optional) | Type of fatca address, values: "correspondence" / "others", to be provided given "residentForTaxInIndia" is "YES" |
----addressCity | String(Optional) | Fatca address city, to be provided given "residentForTaxInIndia" is "YES" |
----addressDistrict | String (Optional) | Fatca address district, to be provided given "residentForTaxInIndia" is "YES" |
----addressStateCode | Enum String(Optional) | Fatca address state code (Refer Table 1.2), to be provided given "residentForTaxInIndia" is "YES" |
----addressState | String(Optional) | Fatca address State (Refer Table 1.2), to be provided given "residentForTaxInIndia" is "YES" |
----addressCountryCode | Enum String(Optional) | Fatca address Country code (Refer Table 1.1), to be provided given "residentForTaxInIndia" is "YES" |
----addressCountry | String(Optional) | Fatca address country (Refer Table 1.1), to be provided given "residentForTaxInIndia" is "YES" |
----addressPincode | String(Optional), valid Pincode | Fatca address Pincode, to be provided given "residentForTaxInIndia" is "YES" |
----address | String(Optional) | Fatca address, to be provided given "residentForTaxInIndia" is "YES" |
----relatedPerson | Enum String(Optional) | whether a related person to investor or investor themselves, values: "YES" / "NO" |
----relatedPersonType | Enum String(Optional) | Type of related person, values: "1" / "2" / "3" for "Guardian of a Minor", "Assignee", and "Authorised Representative" respectively |
----relatedPersonKycNumberExists | Enum String(Optional) | whether the related person has a KYC number, values: "YES" / "NO" |
----relatedPersonKycNumber | String (Optional), valid Kyc number | KYC number of related person |
----relatedPersonTitle | String | Related Person Title, values: "Mr."/ "Mrs." / "Ms." / "Mx." |
----relatedPersonName | String | Name of related person |
----relatedPersonIdentityProof | Object | to be filled if the related person's KYC number does not exist else empty object, see below for details |
----relatedPersonIdentityProofType | Enum String(Optional) | Type of related persons ID proof when related person's KYC number doesn't exists, values: "individualPan"/"aadhaar"/"passport"/"drivingLicence"/"voterId" |
Property | Data Type | Example Values |
type | Enum String (Required) | "individualPan" |
name | String (Required), string of min length of 2 consisting of any character | Name on POI document |
dob | String (Required), date of birth as string in DD/MM/YYYY or DD-MM-YYYY format | DOB on POI document |
number | String (Required), valid PAN number | PAN number on POI document |
fatherName | String (Required), string of min length of 2 consisting of any character | PAN number on POI document |
Property | Data Type | Example Values |
type | Enum String (Required) | "aadhaar" |
name | String (Required), string of min length of 2 consisting of any character | Name on POI document |
uid | String (Required), string of 8 zeros followed by 4 digits | Aadhaar number |
address | String (Required) | Address as on POI document |
city | Enum String (Required) | City as on POI document |
state | Enum String (Required) | State as on POI document, Refer 1st column of Table 1.7 |
district | String (Required) | District as on POI document |
pincode | String (Required), valid Pincode | Pincode |
dob | String (Required), date of birth as string in DD/MM/YYYY or DD-MM-YYYY format | DOB on POI document |
Property | Data Type | Example Values |
type | Enum String (Required) | "passport" |
name | String (Required), string of min length of 2 consisting of any character | Name on POI document |
passportNumber | String (Required) | Passport number |
address | String (Required) | Address as on POI document |
city | Enum String (Required) | City as on POI document |
state | Enum String (Required) | State as on POI document, Refer 1st column of Table 1.7 |
district | String (Required) | District as on POI document |
birthDate | String (Required), date of birth as string in DD/MM/YYYY or DD-MM-YYYY format | DOB on POI document |
pincode | String (Required), valid Pincode | Pincode |
issueDate | String (Required), Issue Date as string in DD/MM/YYYY or DD-MM-YYYY format, should be a past Date | Issue date on the document |
expiryDate | String (Required), Expiry Date as string in DD/MM/YYYY or DD-MM-YYYY format, should be a future Date | Expiry date on the document |
Property | Data Type | Example Values |
type | Enum String (Required) | "drivingLicence" |
name | String (Required), string of min length of 2 consisting of any character | Name on POI document |
dob | String (Required), date of birth as string in DD/MM/YYYY or DD-MM-YYYY format | DOB on POI document |
number | String (Required) | Driving License number on POI document |
address | String (Required) | Address as on POI document |
city | Enum String (Required) | City as on POI document |
state | Enum String (Required) | State as on POI document, Refer 1st column of Table 1.7 |
district | String (Required) | District as on POI document |
pincode | String (Required), valid Pincode | Pincode |
issueDate | String (Required), Issue Date as string in DD/MM/YYYY or DD-MM-YYYY format, should be a past Date | Issue date on the document |
expiryDate | String (Required), Expiry Date as string in DD/MM/YYYY or DD-MM-YYYY format, should be a future Date | Expiry date on the document |
Property | Data Type | Example Values |
type | Enum String (Required) | "voterId" |
name | String (Required), string of min length of 2 consisting of any character | Name on POI document |
dob | String (Required), date of birth as string in DD/MM/YYYY or DD-MM-YYYY format | DOB on POI document |
epicNumber | String (Required) | VoterId number on POI document |
address | String (Required) | Address as on POI document |
city | Enum String (Required) | City as on POI document |
state | Enum String (Required) | State as on POI document, Refer 1st column of Table 1.7 |
district | String (Required) | District as on POI document |
pincode | String (Required), valid Pincode | Pincode |
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 [email protected].