post https://sandbox.cashfree.com/verification/esignature
Use this API to add the details of the document and signer(s) to initiate e-sign verification. View the test data and use the information to trigger the validations. The test data are usable only in test environments such as gamma and sandbox.
Response Codes
| Sub Code | Status | Message | Next Action |
|---|---|---|---|
| 200 | SUCCESS | SUCCESS | - |
| 400 | ERROR | verification_id is missing in the request. | Create a valid verification ID to identify the request. |
| 400 | ERROR | verification_id can include only alphanum, dot, hyphen, and underscores. | Only alphanumeric, period (.), hyphen (-), and underscore ( _ ) are allowed. |
| 400 | ERROR | x-client-id is missing in the request. | Enter all the header information in the API request. |
| 400 | ERROR | document_id is missing in the request. | Enter the unique ID received in the Upload Document for E-Sign API response. |
| 400 | ERROR | Document id provided is invalid. | Enter a valid document ID. |
| 400 | ERROR | Document id provided is expired. | Upload the document again to create the request for signing the document. |
| 400 | ERROR | notification_modes is missing in the request. | Enter how you want to notify the signee about the e-sign details in the request. |
| 400 | ERROR | notification_modes is missing in the request. | Enter how you want to notify the signee about the e-sign details in the request. |
| 400 | ERROR | Notification mode provided is invalid. | Enter a valid notification mode. |
| 400 | ERROR | Maximum number limit of Signer exceeded. | You can only enter a maximum of ten signers. |
| 400 | ERROR | Client secret belongs to test environment | Enter the correct environment credentials in the request. |
| 400 | ERROR | auth_type is missing in the request | Enter the type of authentication to be used for e-signature. |
| 400 | ERROR | expiry_in_days is missing in the request. | Enter the expiry of the signing link for each signer in days. The maximum allowed time is 15 days. |
| 400 | ERROR | signers is missing in the request. | Enter the details of the signer(s) in the request. |
| 400 | ERROR | Duplicate sequence passed for signers | Ensure the sequence entered is unique. |
| 400 | ERROR | Sequence passed for signers is Invalid | Ensure the sequence of signers are less than or equal to the number of signers. |
| 400 | ERROR | Multiple signer is not allowed without email notification mode | If the notification mode is not email, multiple signers are not allowed. |
| 401 | ERROR | Invalid clientId and clientSecret combination | Enter valid client ID and secret key in the request. |
| 403 | ERROR | IP not whitelisted your current ip is 106.51.91.104.For IP whitelisting assistance, visit our guide at https://docs.cashfree.com/docs/ip-whitelisting-verification | Whitelist the IP address. |
| 409 | ERROR | This Verification ID already exists. Provide a different ID. | Enter a unique verification ID to identify the request. |
| 422 | ERROR | Insufficient balance to process this request | Try again with sufficient balance. |
| 500 | ERROR | something went wrong, please try after some time | Try again after some time. |