In addition to the use of seals in a transaction, we offer a standalone seal service.
Before you can request a document to be sealed, you need to:
- Own a Certificate for Legal Person (CPM).
- Make sure the feature is activated on your account.
To request a CPM creation and/or activate the feature on your account, contact your account manager at Universign.
Note that when you use the standalone seal service, sealed documents are not stored. Documents are only stored when you seal a document within the transaction process.
To seal a document, send a multipart/form-data request to POST /v1/seals and pass the document in the file argument as well as the seal id.
Note that we accept only PDF input format in a maximum size limit of 25MB.
curl
https://api.universign.com/v1/seals \
-F [email protected] \
-d seal_id=scd_wa7ZVZGxz0q1 \
-d label="John DOE, CEO of the company"
You can pass optional parameters:
field_page: The page number on which you want to position the seal. Default value is1.field_x: The seal horizontal coordinate on the document page (in pixels). Default value is0.field_y: The seal vertical coordinate on the document page (in pixels). Default value is0.
If you set only required parameters or if you do not set field_page, field_x and field_y parameters, the request returns a 200 response that contains a PAdES document seal with an invisible seal.
-
language: The language of the text in the seal cartridge (“Sealed by [sealname], on [sealdate]”). Expected input format is ISO 639-1. We currently support 11 languages: Bulgarian (bg), Catalan (ca), Dutch (nl), English (en), French (fr), German (de), Italian (it), Polish (pl), Portuguese (pt), Romanian (ro) and Spanish (es). French (fr) is the default language. -
custom_logo: The seal logo that will display on the document. We accept only JPEG and PNG formats in a maximum size limit of 2 MB.
Note: To guarantee high quality resolution, your logo dimensions should be 300px x 72px.
Note that the size of the seal is set to 200px x 50px and cannot be edited. Make sure the seal is well positioned in the document. If any edge of the seal exceeds the document limit, the API returns an error.
-
label: The label that will be displayed on the signature cartridge. Note that thelabelvalue will always be preceded by the expression Sealed by that is automatically generated by our system. The feature needs to be activated on your workspace. signature_type: The type of signature for a standalone seal. Set tocertificationto apply a certification signature on the document. For more details, refer to Certification signatures.certification_permission: Defines which modifications are allowed after a certification signature is applied. Possible values areread_only,fill,annotate. Set only ifsignature_typeis set tocertification.
About certificate permissions
read_only: No changes to the document are permitted. Any change to the document shall invalidate the signature.
fill: Permitted changes shall be filling in forms, instantiating page templates, and signing. Any other change shall invalidate the signature.
annotate: Permitted changes are the same as forfill, as well as annotation creation, deletion, and modification. Any other change shall invalidate the signature.
