Modules
...
Journey Builder
Pages

Contract SDK

8min

When we select the Contract screen type, the onboarding merchant while going through the onboarding process needs to sign the contract then and there, only then the journey is completed.

But in Contract SDK, merchants can fill out all the details, submit the supporting documents, and complete the onboarding journey but can sign the contract later on through their email within a valid time.

The merchant can also sign the contract on the fly/during the journey if the journey doesn't have any sub-merchant added to it, and/or if the 'Allow adding signers?' toggle is disabled. If this toggle is enabled, then the merchant cannot sign the contract on the fly, but later through email.

Contract SDK Overview
Contract SDK Overview


Options to Customize Contract SDK

  • Signature Type: Currently the only option to validate the contract is e-sign.
  • Contract Executer Name: Name of the person who will prepare the contract.
  • Contract Name: Name of the contract that is prepared.
  • Upload Contract Template: Upload a pre-built contract here it can be in .doc or HTML format.
  • Sign on specific pages?: Merchants can be asked to sign on some specific pages.
  • Signing Options: Signing options can be chosen amongst Indian and Global. The Indian signing option is in compliance with the regulations of India and the Global options can be used across all the other journeys which is globally accepted.

Indian

Four signing options are available: Aadhaar Esign, Esign, I accept and I accept with email.

  • Aadhar Esign: This option helps to sign the contract using the data of the Aadhaar of the signer. The signer has to enter the Aadhaar number and the contract will be considered signed on entering the correct OTP sent to the linked mobile number.
    • Enable Name Match: Enabling this toggle verifies the name match between the signer and the data fetched from NSDL or eMudra basis a threshold value the client can decide. This ensures that only the authorized individual can sign the contract using their own Aadhaar details.
      • Name match threshold: A threshold value decided by the client(bank/NBFC) can be entered here. The esign will pass only when the name match score is more than the entered threshold value. The possible threshold values can be between 0.01 to 1.00. The entered value should be in two decimal places.
  • Esign: Enabling this toggle helps to sign the contract digitally using various methods. Any one of the below options has to be selected if the esign method of signing is chosen.
    • Upload Signature: The merchant can upload the image of their signature.
    • Font Signature: This feature lets the merchant choose their name in different font styles for their signature
    • Draw Signature: This option enables the merchant to draw their signature for the contract.
    • Hide Valid Consent in Esign: When the merchant digitally signs the contract, a consent declaration appears, confirming their acceptance of the digital signature as their proxy. Checking the box will hide this consent.
    • Hide Resuse Consent in Esign: When the merchant digitally signs the contract, a consent declaration appears, confirming their acceptance to reuse their esign for further purposes if required. Checking the box will hide this consent.
  • I Accept: This method of signing involves accepting the contract by just clicking on the 'I accept' checkbox at the end of the contract.
  • I Accept with Email: This method of signing involves accepting the contract by just clicking on the 'I accept' checkbox at the end of the contract that is sent to the merchant on their email.
  • Various toggles are present:
  1. Allow adding signers?: Allows to add more signers to the contract.
  2. Restrict editing signers?: Restricts the addition of more signers.
  3. Restrict removing signers?: Restricts the removal of the added signers.
  4. Additional Verification Required: Enabling this toggle adds additional verification to the contract.
    • ID Video: This makes video verification an additional verification for the contract.
    • Mobile OTP: This sends an OTP to the mobile number provided by the merchant.
    • Email OTP: This sends an OTP to the mobile number provided by the merchant.
  5. Prefill signers: The signers can be prefilled. The name and email of the signer can be hardcoded by giving a hardcoded value or can be prefilled by selecting the pages and variables from where it can be prefilled. If 'ID Video' is chosen as the criteria for addition verification then another configuration is added in prefill signers, i.e., Face Match ID, where the pages and variables from which face match ID will be prefilled can be selected.
Options after enabling prefill signers toggle
Options after enabling prefill signers toggle


The signature position can also be customized by enabling the 'Signature Customisations' toggle. The page number(s) where the signature has to be added is entered. The position of the signature for the page(s) can be configured by providing the X and Y coordinates(maximum value 250) for the page. The height and width(maximum value 250) of the signature can also be configured.

Note: This customisation is valid only for a single signer. Also, it is valid only for a dynamic number of signers.

Document image


6. Custom Signature Position: The position and size of the main merchant's signature can be chosen according to requirements. This can be done by selecting its position on the X and Y coordinate and, also putting the value for its height and width. When this toggle is enabled these options appear:

Custom Signature Position options
Custom Signature Position options


7. eStamping: An electronic stamp can also be put on the contract if required. Estamp is a part of the esign module. When the contract is e-signed, a pdf is generated. An estamp is then inserted on the first page of this pdf. Once the estamp is inserted, the reference id of the stamp is embedded on the side of all the pages of the contract. When the toggle for estamp is enabled the below fields have to be filled out:

Options to customize eStamp
Options to customize eStamp


Global

  • Upload Signature: This option helps to sign the contract by simply uploading a file containing the signature.
  • Font Signature: The applicant gets multiple options of font styles in which their name is written to sign the contract.
  • Draw Signature: This is the option with the help of which the applicant can draw the signature on the screen in real time.
  • Hide valid consent in Esign?: This hides the consent box during esign.
  • Hide reuse consent in Esign?: When an applicant signs a contract a checkbox askes them if their consent can be reused in case of any other onboarding, this option hides that checkbox for reuse of consent.
  • Various toggles are present:
  1. Allow adding signers?: Allows to add more signers to the contract.
  2. Restrict editing signers?: Restricts the addition of more signers.
  3. Restrict removing signers: Restricts the removal of the added signers.
  4. Additional Verification Required: Enabling this toggle adds additional verification to the contract.
    • ID Video: This makes video verification an additional verification for the contract.
    • Mobile OTP: This sends an OTP to the mobile number provided by the merchant.
    • Email OTP: This sends an OTP to the mobile number provided by the merchant.
  5. Prefill Signers: The signers can be prefilled. The name and email of the signer can be hardcoded by giving a hardcoded value or can be prefilled by selecting the pages and variables from where it can be prefilled. If 'ID Video' is chosen as the criteria for addition verification then another configuration is added in prefill signers, i.e., Face Match ID, where the pages and variables from which face match ID will be prefilled can be selected.
Options after enabling prefill signers toggle
Options after enabling prefill signers toggle


7. Custom Signature Position: The position and size of the signature can be chosen according to requirements. This can be done by selecting its position on the X and Y coordinate and, also putting the value for its height and width. When this toggle is enabled these options appear:

Custom Signature Position options
Custom Signature Position options


8. eStamping: An electronic stamp can also be put on the contract if required. Estamp is a part of the esign module. When the contract is e-signed, a pdf is generated. An estamp is then inserted on the first page of this pdf. Once the estamp is inserted, the reference id of the stamp is embedded on the side of all the pages of the contract. When the toggle for estamp is enabled the below fields have to be filled out:

Options to customise eStamp
Options to customise eStamp

  • Sequential Signing: If a contract has multiple signers, then each signer gets a mail to sign the contract they can sign it one by one sequentially. Another signer can sign the contract only when the previous signer has finished signing.
  • Parallel Signing: In this case, if there are multiple signers, all of them get the mail for signing the contract at once. Any one of them can sign the contract without following a sequence, but if one signer is in the process of signing the contract then another cannot simultaneously.
  • Validity Time(in seconds): The time for which the contract is valid for signing by the merchant can be configured here in epoch time. (Default is 14 days, i.e., 1209600)
  • Contract Reminder Frequency(in seconds): Signers who have not yet signed the contract will receive reminders at specified time intervals, which are configured here.

Contract SDK Mapping

The Contract or Contract SDK utilizes a Docx templator that can also work seamlessly with HTML files to generate PDF documents. {{Write a few use cases for contract SDK here}} The templator is designed to accept either a .docx or .html file as an input, with variables strategically mapped within the template. These variables must be from within the Configuration Engine (GO Admin) elements including but not limited to textboxes, radio buttons, checkboxes, and so on.

To effectively map these variables within the contract template, a standardized format has been created. For .docx templates, you can use {pageid, variablename} or {variablename} to map the variables within the .docx template.

On the other hand, for .html templates, the format {{pageid.variablename}} is recommended for mapping the variables within the .html template.

For the mapping of sub-flow persona details, a closed loop must be defined using the keys {#personaData} and {/personaData}. Within these two keys, the details of the sub-flow persona should be defined. With this simple snippet, the final PDF generated will replicate for every persona, ensuring consistency across all sub-flows.

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



Updated 27 Sep 2024
Did this page help you?