Introduction
Envelope Signing (eSign) provides a complete set of electronic signing APIs, supporting the full workflow from file upload to signing completion.
What is an Envelope?
In Tencent eSign, an Envelope is the core container for a signing workflow. An envelope contains:
- Documents — Files to be signed (PDF, Word, etc.)
- Recipients — Signers or Carbon Copy recipients
- Tabs — Signing fields such as signature, date, text box, etc., positioned on documents
- Signing Settings — Parallel/sequential signing, whether decline is allowed, etc.
Envelope Lifecycle
draft → sent → completed
↘ declined
↘ voided| Status | Description |
|---|---|
draft | Draft, not yet sent |
sent | Sent, signing workflow in progress |
completed | All signers have signed |
declined | A signer declined to sign |
voided | Sender recalled the envelope, or auto-voided when the signing deadline is reached |
ℹ️
Envelopes created via the Open API are sent immediately (skipping the draft state) and enter the sent status upon creation.
API Reference
POSTPOSTPOSTPOST
Upload Files
/openapi/v1/files/upload
Upload document files and obtain FileIds
Create and Send Envelope
/openapi/v1/envelopes
Create and send an envelope in a single call
Get Envelope Detail
/openapi/v1/envelopes/detail
Query envelope status and signing progress
Get Signing/Viewing Link
/openapi/v1/envelopes/{envelopeId}/signing-url
Generate a one-time signing or viewing link