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