Integrate WebSign in iframe


After sending the envelope, you can obtain the signing URL for the current signer(s) from the SendEnvelope response. The response contains the URL in a property called "SigningUrl".

Important!

Please see this working sample code

Our recommended definition for the iframe definition markup is :

<iframe sandbox="allow-same-origin allow-scripts allow-popups allow-forms" src="" >
</iframe>

Also please remember the bigger the iframe size, the better the user experiencewhile signing will be. A small iframe makes it very hard for the user to read the document(s) which need to be signed.

Receive signing events when integrating Websign in iframe

When hosting the signing application in a iframe is possible to also receive the same client side custom events as when extending directly the signing application.

To enable triggering these events you must enable the "Trigger events when integrating WebSign in a iframe" option located in Signing Settings.

How are the events dispatched ?

To receive the events you must subscribe to the "message" event, like this :

      window.addEventListener('message', function(event) {
                console.log('received message: ', event.data);
            }, false);
  • the events are dispatched as JSON strings with the following format
   {"event" : "DocumentsLoaded"}

If the events contains parameters, they will be added to the JSON starting with index 0 , like this :

{"0": "113-2345-5454432-234212", "event" : "Signed"}
Important!

Please note that due to the blocking on 3rd party cookies by default in latest browser versions, OUR RECOMMANDATION for integration is to redirect to WebSign instead of using an iframe. Please see this