Redirection Approach - Alternate option to SDK integration
This option should be used by businesses where the signers are remote and the signing activity can be performed at a later point of time and not part of the flow of an ongoing transaction process OR if in case the corporate wishes to send customized email/SMS etc from their end directly. Signers can then click the link and directly land on Digio application to authenticate and eSign the document You can create eSign links that you can send over email /sms for the user to directly land on the Digio application to eSign the document.
NOTE: This approach can be used for Hybrid applications, iOS and React integrations.
Sandbox:
- Server side API call to: https://ext.digio.in:444
- Front end (pop up URL): https://ext.digio.in
Production:
- Server side API call to: https://api.digio.in
- Front end (pop up URL): https://app.digio.in
Step-1: How to create an eSign link ?
- Create URL base formula:
- BASE_URL + documentId +"/"+ any_random_value_as_txn_id +"/"+ signer_identifier"
- Production base url : https://app.digio.in/#/gateway/login/
- Sandbox base url: https://ext.digio.in/#/gateway/login/
- Sample URL in production : https://app.digio.in/#/gateway/login/DID170829163815543Q3LG28D8BCZ2PK/vI3atY/sanket@digio.in
Step-2: How to retrieve success event using redirection pass redirect_url query parameter ?
-
Sample URL :
- https://app.digio.in/#/gateway/login/DID170829163815543Q3LG28D8BCZ2PK/vI3atY/sanket@digio.in?redirect_url=https://my_redirection_url
- On successful signing a redirection is made as :
- redirection_url?status=success&digio_doc_id= docId +&message=Signing Success
-
Sample :
- https://my_redirection.com?status=success&digio_doc_id=DID170829163815543Q3LG28D8BCZ2PK&message=Signing Success
- Businesses can retrieve signed documents using the download document API on success event retrieved. If you are doing it at mobile webviews, redirection url can be a dummy URL and you can listen to the redirection events and translate the event into a success or failure result For iOS:
- Load the final URL in an iOS webview. Webviews have a redirection listener. You can pass a dummy redirection_url query parameter and check if the redirection event has a URL as a passed redirection URL. Based on that read status value and message
Step-3: How to pass a business logo ?
- https://app.digio.in/#/gateway/login/DID170829163815543Q3LG28D8BCZ2PK/vI3atY/sanket@digio.in?redirect_url=https://my_redirection_url&logo=www.mylogo.com
- Note:
- Please ensure redirect_url and logo is passed with in encoded format by using Javascript encodeURIComponent
- Example here : https://www.w3schools.com/jsref/jsref_encodeURIComponent.asp
- Please ensure validity for eSign workflow is passed properly, so that the signer can sign the document before workflow expiry