Update Form Address Proof

15 min

Updates Permanent POA form data of a Merchant

Only the POA that has been approved for the distributor by the AMC will be accepted and any other ID uploaded will throw an error. So if for a particular distributor, if DL card is the only approved POA, then uploading Aadhaar as POA will throw an error.

Endpoint

/api/onboardings/updateForm

Headers

Property	Value
Content-type	application/json
Authorization	…access token… (alphanumeric string of length 64)

Input

Property	Data Type	Example Values
merchantId	String (Required) alphanumeric string of length 24	userId from the investor login response field
save	String (Required)	“formData”
type	String (Required)	“addressProof”
data	Object (Required)	payload, see below for details

Object Details when POA is Aadhaar

{
    "merchantId": ".. merchantId ..",
    "save": "formData",
    "type": "addressProof",
    "data": {
        "type": "aadhaar",
        "name": ".. person name ..",
        "uid": "..12 digit UID ..",
        "address": ".. address ..",
        "city": ".. city ..",
        "pincode": ".. pincode ..",
        "state": ".. state ..",
        "district": ".. district ..",
        "dob": ".. dob .."
    }
}

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 POA document
uid	String (Required), string of 8 zeros followed by 4 digits	Aadhaar number
address	String (Required)	Address as on POA document
city	Enum String (Required)	City as on POA document
state	Enum String (Required)	State as on POA document, Refer 1st column of Table 1.7
district	String (Required)	District as on POA 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 POA document

Object Details when POA is Passport

{
    "merchantId": ".. merchantId ..",
    "save": "formData",
    "type": "addressProof",
    "data": {
        "type": "passport",
        "name": ".. name ..",
        "birthDate": ".. dob ..",
        "issueDate": ".. issueDate ..",
        "expiryDate": ".. expiryDate ..",
        "passportNumber": ".. passport number ..",
        "address": ".. address ..",
        "city": ".. city ..",
        "state": ".. state ..",
        "district": ".. district ..",
        "pincode": ".. pincode .."
    }
}

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 POA document
passportNumber	String (Required)	Passport number
address	String (Required)	Address as on POA document
city	Enum String (Required)	City as on POA document
state	Enum String (Required)	State as on POA document, Refer 1st column of Table 1.7
district	String (Required)	District as on POA document
birthDate	String (Required), date of birth as string in DD/MM/YYYY or DD-MM-YYYY format	DOB on POA 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

Object Details when POA is Driving License

{
    "merchantId": ".. merchantId ..",
    "save": "formData",
    "type": "addressProof",
    "data": {
        "type": "drivingLicence",
        "name": ".. name ..",
        "expiryDate": "... expiryDate ..",
        "number": ".. DL number ..",
        "dob": ".. dob .. ",
        "issueDate": ".. issueDate ...",
        "address": ".. address ..",
        "city": ".. city ..",
        "state": ".. state ..",
        "district": ".. district ..",
        "pincode": ".. pincode .."
    }
}

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 POA document
dob	String (Required), date of birth as string in DD/MM/YYYY or DD-MM-YYYY format	DOB on POA document
number	String (Required)	Driving License number on POA document
address	String (Required)	Address as on POA document
city	Enum String (Required)	City as on POA document
state	Enum String (Required)	State as on POA document, Refer 1st column of Table 1.7
district	String (Required)	District as on POA 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

Object Details when POA is VoterId

{
    "merchantId": ".. merchantId ..",
    "save": "formData",
    "type": "addressProof",
    "data": {
        "type": "voterId",
        "epicNumber": ".. voterId number ..",
        "name": ".. name ..",
        "dob": ".. dob ..",
        "state": ".. state ..",
        "district": ".. district ..",
        "address": ".. address ..",
        "city": ".. city ..",
        "pincode": ".. pincode .."
    }
}

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 POA document
dob	String (Required), date of birth as string in DD/MM/YYYY or DD-MM-YYYY format	DOB on POA document
epicNumber	String (Required)	VoterId number on POA document
address	String (Required)	Address as on POA document
city	Enum String (Required)	City as on POA document
state	Enum String (Required)	State as on POA document, Refer 1st column of Table 1.7
district	String (Required)	District as on POA document
pincode	String (Required), valid Pincode	Pincode

Object Details when POA is Offline Aadhaar

{
    "merchantId": ".. merchantId ..",
    "save": "formData",
    "type": "addressProof",
    "data": {
        "type": "aadhaarXml",
        "name": ".. person name ..",
        "uid": "..12 digit UID ..",
        "address": ".. address ..",
        "city": ".. city ..",
        "state": ".. state ..",
        "district": ".. district ..",
        "pincode": ".. pincode ..",
        "dob": ".. dob ..",
        "generationDateTime": "..generationDate+generationTime..",
        "dateDifference": ..dateDifference..
    }
}

Property	Data Type	Example Values
type	Enum String (Required)	“aadhaarXml”
name	String (Required), string of min length of 2 consisting of any character	Name on POA document
uid	String (Required), string of 8 zeros followed by 4 digits	Aadhaar number
address	String (Required)	Address as on POA document
city	Enum String (Required)	City as on POA document
state	Enum String (Required)	State as on POA document, Refer 1st column of Table 1.7
district	String (Required)	District as on POA 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 POA document
generationDateTime	String (Required), concat the generationDate and generationTime	Generation date and time on POI document
dateDifference	Number (Required), dateDiffence	dateDifference in POA document

Object Details when POA is Aadhaar DigiLocker

{
    "merchantId": ".. merchantId ..",
    "save": "formData",
    "type": "addressProof",
    "data": {
        "type": "aadhaarDigiLocker",
        "name": ".. person name ..",
        "uid": "..12 digit UID ..",
        "address": ".. address ..",
        "city": ".. city ..",
        "state": ".. state ..",
        "district": ".. district ..",
        "pincode": ".. pincode ..",
        "dob": ".. dob .."
    }
}

Property	Data Type	Example Values
type	Enum String (Required)	“aadhaarDigiLocker”
name	String (Required), string of min length of 2 consisting of any character	Name on POA document
uid	String (Required), string of 8 zeros followed by 4 digits	Aadhaar number
address	String (Required)	Address as on POA document
city	Enum String (Required)	City as on POA document
state	Enum String (Required)	State as on POA document, Refer 1st column of Table 1.7
district	String (Required)	District as on POA 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 POA document

Object Details when POA is Driving License DigiLocker

{
    "merchantId": ".. merchantId ..",
    "save": "formData",
    "type": "addressProof",
    "data": {
        "type": "dlDigiLocker",
        "name": ".. name ..",
        "expiryDate": "... expiryDate ..",
        "number": ".. DL number ..",
        "dob": ".. dob .. ",
        "issueDate": ".. issueDate ...",
        "address": ".. address ..",
        "city": ".. city ..",
        "state": ".. state ..",
        "district": ".. district ..",
        "pincode": ".. pincode .."
    }
}

Property	Data Type	Example Values
type	Enum String (Required)	“dlDigiLocker”
name	String (Required) ,string of min length of 2 consisting of any character	Name on POA document
dob	String (Required) ,date of birth as string in DD/MM/YYYY or DD-MM-YYYY format	DOB on POA document
number	String (Required)	Driving License number on POA document
address	String (Required)	Address as on POA document
city	Enum String (Required)	City as on POA document
state	Enum String (Required)	State as on POA document, Refer 1st column of Table 1.7
district	String (Required)	District as on POA 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

Expected Output

{
    "object": "Updated Successfully"
}

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