By now, you will have a doc_id. You will need this to request the user’s signature.
There are 3 ways your user can sign a document:
- Direct the user to a signing page (no-code)
- Embed the signing page in an iframe
- Implement the signing page by yourself (sign locally)
Direct the user to a signing page (no-code)
Direct the user to the document link. The signing page may look something like this.
What’s the document link?
If you used eID Easy to prepare your document template, your document link will look something like this:
https://id.eideasy.com/sign_contract?client_id=j9FXBpH0S…
Add these parameters to the URL:
| client_id | REQUIRED. Your website’s client_id, as shown in the id.eideasy.com portal. |
| contract_id | REQUIRED. Your template’s contract_id. |
| code | OPTIONAL. If you used the API to pre-fill the template before signing, use this parameter to direct the user to the pre-filled contract. |
If you uploaded your own file to eID Easy, your document link will look something like this:
https://id.eideasy.com/sign_contract_external?client_id=j9FXBpH0S…
Add these parameters to the url:
| client_id | REQUIRED. Your website’s client_id, as shown in the id.eideasy.com portal. |
| doc_id | REQUIRED. The doc_id value you received after uploading your file. |
Optionally, you may add the following parameters to the url:
| enabled_methods | Comma separated list of methods that are allowed for signing at this moment. Possible options are &enabled_methods=id-signature,mid-signature,smart-id-signature |
| signature_redirect | Where to redirect the user after signature is completed. You can customize it to your own needs and set the state needed after signing is finished. For example, you may wish to add items to shopping cart etc. &signature_redirect=https://shop.com/add_to_cart.php?item=123 |
| nodownload | By default, after the signing the signed container will be downloaded to the user’s computer. If this is not needed and you want to display signed file only in your own systems then set &nodownload=true |
| noemails | By default the notification e-mail is sent after every signature. If you are dealing with automated system and do not need to get e-mail every time then turn the e-mails off with &noemails=true |
| email_extra | If you prefer to get e-mail notifications and know who or what is the signature about then send any values here that you wish to add to the e-mail subject. Example &email_extra=Kersti+Kaljulaud+drone+flight+permission+application+drooniluba |
| country | When using Smart-ID signatures, you can preselect country value. Default EE and options EE, LT, LV. Make sure these are uppercased |
| idcode | When using Smart-ID signatures, you may use this to prefill idcode value |
| mobileno | When using Smart-ID signatures, you may use this to prefill mobile phone number value |
Embed the signing page in an iframe
If you wish to keep the user on your page, you may embed the above-mentioned signing page into an iframe.
Implement the signing page by yourself (sign locally)
This means you will need to implement both the back-end and front-end parts yourself.
You have a couple of options regarding the front-end functionality:
- You can implement it from scratch using our API’s start signing and finish signing endpoints
- You can use our browser client, which handles the communication with our API, but does not provide any UI elements. Probably the best option if you wish to write your own custom UI.
- You can use our widget, which is a full-fledged embeddable UI component built on top of our browser client. This is the easiest option, but you will not have full control over the visual side of the UI.
Note! Local signing is not publicly available for templates. If you need this functionality, get in touch with us.
Note! Local signing is not available for the Latvian eParaksts method, due to eParaksts’ redirect-oriented nature.