eStamping API | Digital stamping in Zoho Sign

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 - 48 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 - 48 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. "dummy" "1234" "borrower" "tenant" "landlord" "vendor" "customer" "firstparty" "second party" "first party" "second party" "land lord" "party" "first" "second" "1st" "2nd"
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	This is optional if the value passed in document_category is Affidavit and Power of Attorney. consideration_amount value should be greater than or equal to 1.
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: Individual Organization Government
first_party_id_type *			Refers to the duty payer's ID proof type. Possible values: Individual: DLN - Drivers License Number PAN - Permanent Account Number PPN - Passport Number VID - Voter ID number UID - Aadhaar Number TAN - Tax Deduction and Collection Account Number Organization: PAN - Permanent Account Number
first_party_id_number *			ID number of the duty payer. Validations: DLN - Drivers License Number Max Length: 16 Type: Alphanumeric Datatype: String PAN - PAN Card Number Length: 10 Type: Alphanumeric Data type: String PPN - Passport Number Length: 8 Type: Alphanumeric Data type: String VID - Voter ID Number Length: 10 Type: Alphanumeric Data type: String UID - Aadhaar Number Length: 12 Type: Numeric Data type: String
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: Individual Organization Government
second_party_id_type *			Refers to the duty payer's ID proof type. Possible values: Individual: DLN - Drivers License Number PAN - Permanent Account Number PPN - Passport Number VID - Voter ID number UID - Aadhaar Number TAN - Tax Deduction and Collection Account Number Organization: PAN - Permanent Account Number
second_party_id_number			ID number of the duty payer. Validations: DLN - Drivers License Number Max Length: 16 Type: Alphanumeric Datatype: String PAN - PAN Card Number Length: 10 Type: Alphanumeric Data type: String PPN - Passport Number Length: 8 Type: Alphanumeric Data type: String VID - Voter ID Number Length: 10 Type: Alphanumeric Data type: String UID - Aadhaar Number Length: 12 Type: Numeric Data type: String
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: { "property_address": { "addressline_1": "<Property description>", } }
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: Sq.meter Sq.Feet Acres Guntha Hectare

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 for the vendor Melento(formerly SignDesk)
eStamping supported states and their document category codes for the vendor eDrafter

API Endpoint

CopiedPUT https://sign.zoho.in/api/v1/requests/<REQUEST_ID>

Sample request

Copied$ 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",
                      "vendor_id": 10 (or) 20 //10 for SignDesk & 20 for eDrafter,
                    "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

Copied$ 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": "4***********8",
        "document_order": 0,
        "estamping_request": {
          "stamp_duty_paid_by": "First Party",
          "vendor_id": 20,
          "stamp_state": "DL",
          "stamp_amount": "400",
          "document_category": "9",
          "first_party_name": "RAM",
          "second_party_name": "Sam",
          "duty_payer_phone_number": "9********1",
          "consideration_amount": "100",
          "duty_payer_email_id": "ram.m@gamil.com",
          "first_party_details": {
            "first_party_entity_type": "Individual",
            "first_party_id_type": "DLN",
            "first_party_id_number": "1928282888811111"
          },
          "first_party_address": {
            "country": "India",
            "street_address": "ram nagar",
            "city": "chennai",
            "state": "TN",
            "pincode": "639001"
          },
          "second_party_address": {
            "country": "India",
            "street_address": "Sam nagar",
            "city": "chennai",
            "state": "TN",
            "pincode": "639003"
          }
        }
      }
    ]
  }
}

Sample input for Maharashtra

Copied$ 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": "4***********8",
        "document_order": 0,
        "estamping_request": {
          "stamp_duty_paid_by": "First Party",
          "document_category": "5",
          "stamp_state": "AP",
          "stamp_amount": "900",
          "second_party_name": "Sam",
          "duty_payer_phone_number": "9********1",
          "vendor_id": 20,
          "first_party_name": "RAM",
          "consideration_amount": "100",
          "duty_payer_email_id": "ram.m@gamil.com",
          "first_party_details": {
            "first_party_entity_type": "Individual",
            "first_party_id_number": "1928282888811111",
            "first_party_id_type": "DLN"
          },
          "first_party_address": {
            "street_address": "ram nagar",
            "country": "India",
            "city": "chennai",
            "state": "TN",
            "pincode": "639001"
          },
          "second_party_address": {
            "street_address": "Sam nagar",
            "country": "India",
            "city": "chennai",
            "state": "TN",
            "pincode": "639003"
          }
        }
      }
    ]
  }
}