How do I send and collect signatures on stamp paper?
Zoho Sign now supports e-stamping, through which Indian businesses can now pay the stamp duty online and have the digitally rendered e-stamp challan appended onto the electronic documents. Additionally, you can also have your recipients digitally sign your business documents using their Aadhaar.
Note: Please enable eStamping from Zoho Sign's dashboard. Learn how.
Learn how to enforce your signers sign documents with Aadhaar eSign
Arguments
Param | Datatype | Maximum length | Description |
---|---|---|---|
first_party_name * | String | Max length - 40 SHCIL - Alphanumeric with space and dot (.) eSBTR- No special characters are allowed. | Name and details of the first party |
second_party_name * | String | Max length - 40 SHCIL - Alphanumeric with space and dot (.) eSBTR- No special characters are allowed. | Name and details of the second party |
Below values will not be passed through first_party_name and second_party_name parameters.
| |||
duty_payer_phone_number * | String | Max/Min length - 10 | Phone number of the first party. |
first_party_address | Address of the first party | ||
second_party_address | Address of the second party | ||
first_party_address and second_party_address will contain the following parameters. | |||
street_address * | String | Min length - 3 Max length - 200 Special characters allowed: hyphen(-), comma (,), dot (.), colon (:), forward slash (/) and space. | Street address of first and second party. |
locality | String | Max length - 100 Special characters allowed: hyphen(-), comma (,), dot (.), colon (:), forward slash (/) and space. | Locality of the first and second party. |
city * | String | Max length - 30 | City of the first and second party |
state * | String | Max length - 30 | State of the first and second party. Use the given state codes instead of state names. Refer to this table. |
pincode | String | Max/Min length - 6 | Pincode of the first and second party. |
country | String | Max length - 7 | County name of the first and second party |
consideration_amount * | String | Max length - 10 |
|
stamp_state * | String | State of the stamp paper. Supported states: Tamil Nadu - TN Gujarat - GJ Delhi - DL Karnataka - KA Rajasthan - RJ Maharashtra - MH | |
stamp_duty_paid_by * | String | Refers to which party is paying the stamp duty. If second_party is the payee, duty_payer_email_id and duty_payer_phone_number will be mandatory fields. | |
document_category * | Document category to which eStamp must be appended. Refer this sheet for the relevant state and document code. | ||
document_reference_code | String | Max length - 20 | Contains the document's reference number |
first_party_details | |||
first_party_entity_type * | Duty payer's entity type must be mentioned here. Possible values:
| ||
first_party_id_type * | Refers to the duty payer's ID proof type. Possible values: Individual:
Organization:
| ||
first_party_id_number * | ID number of the duty payer. Validations: DLN - Drivers License Number
PAN - PAN Card Number
PPN - Passport Number
VID - Voter ID Number
UID - Aadhaar Number
| ||
second_party_details (Will be required if eSBTR is being used for the state of Maharashtra) | |||
second_party_entity_type * | Duty payer's entity type must be mentioned here. Possible values:
| ||
second_party_id_type * | Refers to the duty payer's ID proof type. Possible values: Individual:
Organization:
| ||
second_party_id_number | ID number of the duty payer. Validations: DLN - Drivers License Number
PAN - PAN Card Number
PPN - Passport Number
VID - Voter ID Number
UID - Aadhaar Number
| ||
esbtr_details (Required only if stamp_state is Maharashtra) | |||
district * | The district for which the eSBTR is issued for. Please find the list of districts and their corresponding sub-registrar offices here. | ||
sub_registrar_office * | The sub registrar office details must be provided here. Please find the list of districts and their corresponding sub-registrar offices here. | ||
property_address * | Check this table to see if the property details are mandatory is Yes. If yes, all the below parameters must be filled. If not, follow the below JSON structure:
| ||
addressline_1 * | String | Max length - 60 Min length - 3 | Property's address must be provided here. |
road * | String | Max length - 16 | Property's street address must be provided here. |
town_village * | String | Max length - 16 | Town or village details of the property must be entered here. |
district * | String | Max length - 16 | District name of the property. |
state * | String | Max length - 16 | Property's state name |
pincode * | String | Max length - 6 | Pincode of the locality where the property is located. |
property_area * | Area of the property | ||
proprty_area_unit * | Unit area of the property. Possible values:
|
State/Union territory abbreviation
State/UT | Abbreviation |
---|---|
Karnataka | KA |
Gujarat | GJ |
Maharashtra | MH |
Rajasthan | RJ |
Tamil Nadu | TN |
Delhi | DL |
You can find the abbreviation of all the Indian states here.
eStamping supported states and their document category codes
API Endpoint
PUT https://sign.zoho.in/api/v1/requests/<REQUEST_ID>
Sample request
$ curl https://sign.zoho.in/api/v1/requests/[Request Id] \
-X PUT \
-H "Authorization: Zoho-oauthtoken <Oauth Token>"\
-d 'data= {
"requests": {
"document_ids": [
{
"document_id": "<document id>",
"document_order": 0,
"estamping_request": {
"stamp_duty_paid_by": "First Party",
"stamp_state": "<enter state code>",
"document_category": "<enter document category",
"stamp_amount": 100,
"first_party_name": "First party name",
"duty_payer_phone_number": "<enter phone number>",
"second_party_name": "Second party name",
"consideration_amount": <enter consideration amount>,
"first_party_details": {
"first_party_entity_type": "Individual",
"first_party_id_type": "<id type>",
"first_party_id_number": "<id number>"
},
"second_party_details": {
"second_party_id_type": "<id type>",
"second_party_entity_type": "Individual",
"second_party_id_number": "<id number>"
},
"first_party_address": {
"country": "India",
"street_address": "ABC street",
"city": "xyz city",
"state": "MH",
"pincode": "333333"
},
"second_party_address": {
"country": "India",
"state": "<state code>",
"street_address": "ABC street",
"city": "xyz city",
"pincode": "333333"
},
}
}
]
}
}'
Sample input for Delhi
$ curl https://sign.zoho.in/api/v1/requests/[Request Id] \
-X PUT \
-H "Authorization: Zoho-oauthtoken <Oauth Token>"\
-d 'data= {
"requests": {
"document_ids": [
{
"document_id": "**************************",
"document_order": 0,
"estamping_request": {
"stamp_duty_paid_by": "First Party",
"stamp_state": "DL",
"document_category": "30",
"stamp_amount": 100,
"first_party_name": "First party name",
"duty_payer_phone_number": "9876543210",
"second_party_name": "Second party name",
"consideration_amount": 1000,
"first_party_details": {
"first_party_entity_type": "Individual",
"first_party_id_type": "PAN",
"first_party_id_number": "BAJPC4350M"
},
"first_party_address": {
"country": "India",
"street_address": "ABC street",
"city": "xyz city",
"state": "DL",
"pincode": "333333"
},
"second_party_address": {
"country": "India",
"state": "DL",
"street_address": "ABC street",
"city": "xyz city",
"pincode": "333333"
}
}
}
]
}
}'
Sample input for Maharashtra
$ curl https://sign.zoho.in/api/v1/requests/[Request Id] \
-X PUT \
-H "Authorization: Zoho-oauthtoken <Oauth Token>"\
-d 'data= {
"requests": {
"document_ids": [
{
"document_id": "24036..............396048",
"document_order": 0,
"estamping_request": {
"stamp_duty_paid_by": "First Party",
"stamp_state": "MH",
"document_category": "100",
"stamp_amount": 100,
"first_party_name": "First party name",
"duty_payer_phone_number": "1234567890",
"second_party_name": "Second party name",
"consideration_amount": 1000,
"first_party_details": {
"first_party_entity_type": "Individual",
"first_party_id_type": "PAN",
"first_party_id_number": "BAJPC4350M"
},
"second_party_details": {
"second_party_id_type": "PAN",
"second_party_entity_type": "Individual",
"second_party_id_number": "BAJPC4350M"
},
"first_party_address": {
"country": "India",
"street_address": "ABC street",
"city": "xyz city",
"state": "MH",
"pincode": "333333"
},
"second_party_address": {
"country": "India",
"state": "DL",
"street_address": "ABC street",
"city": "xyz city",
"pincode": "333333"
},
"esbtr_details": {
"district": "1601-PALGHAR",
"sub_registrar_office": "IGR134-VSI2_VASAI+NO+2+JOINT+SUB+REGISTRAR",
"property_address": {
"state": "MH",
"pincode": "400705",
"addressline_1": "xyz",
"road": "abc roal",
"town_village": "Vashi",
"district": "Navi Mumbai"
},
"property_area": "1200",
"property_area_unit": "Sq.Meter"
}
}
}
]
}
}'