PDF signatures: visible marks vs eSignature
Understand the boundaries between placing your own handwritten/typed mark, requesting signatures from others, and certificate-backed digital signing.
Three different PDF signing capabilities#
Visible signing (implemented): use the Sign PDF API to place typed names, dates or user-provided PNG signatures on an authorized document. Output is a new PDF with visible marks, not a cryptographic or identity-verified signature.
Signature requests (sandbox integration implemented): send a document to one or more recipients, explicitly approve sending, track viewed/signed/declined states and retrieve a completed PDF after provider processing. The PDFHQ eSign envelope API uses Dropbox Sign in test mode. Production dispatch and legally binding envelopes are not enabled yet.
Certificate-backed signing (not implemented): signed PDF certificate operations such as PAdES and qualified electronic signatures require trusted certificates and, for qualified signatures, an accredited provider. Visible PDF marks cannot substitute for these guarantees.
Current task request#
curl -X POST 'https://api.pdfhq.io/v1/tasks' \
-H 'x-api-key: YOUR_API_KEY' -H 'Content-Type: application/json' \
-d '{"tool":"sign"}'
# Upload and confirm each PDF; POST /tasks/TASK_ID/files with its upload_id.
# Then process this task:
curl -X POST 'https://api.pdfhq.io/v1/tasks/TASK_ID/process' \
-H 'x-api-key: YOUR_API_KEY' -H 'Content-Type: application/json' \
-d '{"options":{"marks":[{"kind":"typed","page":1,"x0":72,"y0":650,"x1":320,"y1":715,"text":"Jane Doe"}]}}'Place up to 12 marks on unrotated pages. The API validates geometry, image type and dimensions, returns clear errors and rejects documents with existing digital signatures to avoid inadvertently invalidating them.
Privacy, credits and legal considerations#
PDFHQ uses the ordinary HQ Credit-backed processing task for visible signing. Signature images travel through the authenticated task manifest and private worker, not through a separate third-party provider. Do not use these marks to impersonate a signer.
Electronic-signature validity is context and jurisdiction dependent. For regulated or cross-border contracts, engage counsel and use a provider supporting the required evidence, identity verification and signing level.
