Embedding sign link in an Iframe
You can generate the embedded signing link by referring to this article Get embedded signing link and embed that link into your application using Iframe.
Please refer to the following example code snippet to embed the signing link into an Iframe.
<iframe
src = "https://app.boldsign.com/document/sign/?documentId=17882f5a-xxxx-xxxx-xxxx-ce5737756339s_dyU07s_hkU07;dfeab145-xxxx-xxxx-xxxx-d705b85823c8"
width = "100%"
height = "100%">
</iframe>
Client side events
Client side events are special events that are triggered from the embedded sign page to host/parent (Your website).
There are currently six events available, and they are listed, as follows.
| onDocumentSigned | This event will be triggered after the signer successfully completes the signing process of the document. |
| onDocumentSigningFailed | This event will be triggered if any failure occurs while the signer completes the signing process of the document. |
| onDocumentReassigned | This event will be triggered after the signer successfully completes the reassigning process of the document. |
| onDocumentReassigningFailed | This event will be triggered if any failure occurs while the signer completes the reassigning process of the document. |
| onDocumentDeclined | This event will be triggered after the signer successfully completes the declining process of the document. |
| onDocumentDecliningFailed | This event will be triggered if any failure occurs during the signer's completion of the document declining process. |
Please refer to the following sample code snippet for handling this event in your application.
Usage
<script>
window.addEventListener("message", function (params) {
if (params.origin !== "https://app.boldsign.com") {
return;
}
switch (params.data.action) {
case "onDocumentSigned":
// handle document signing success
break;
case "onDocumentSigningFailed":
// handle document signing failure
break;
case "onDocumentReassigned":
// handle document reassigning success
break;
case "onDocumentReassigningFailed":
// handle document reassigning failure
break;
case "onDocumentDeclined":
// handle document declining success
break;
case "onDocumentDecliningFailed":
// handle document declining failure
break;
default:
break;
}
});
</script>
Webhooks
If you've subscribed to the Document Signed, your URL will receive a webhook request when the signer successfully completes the document signing process. You can synchronize the document status, signer's signing status, and any document configuration changes made within the embedded sign in your application/DB.
After your signer has signed the document, you can expect to download the completed document at your end. However, the final PDF generation will take some time. So, you can subscribe to our Document Completed event, which will be triggered after everyone has signed the document and the final PDF file has been generated.